CEdit::SetCueBanner
Définit le texte affiché comme un caractère indicateur de texte, ou la fin, dans un contrôle d'édition lorsque le contrôle est vide.
BOOL SetCueBanner(
LPCWSTR lpszText
);
BOOL SetCueBanner(
LPCWSTR lpszText,
BOOL fDrawWhenFocused = FALSE
);
Paramètres
[in] lpszText
Pointeur vers une chaîne qui contient le caractère indicateur à afficher dans le contrôle d'édition.[in] fDrawWhenFocused
Si false, la bannière de caractère indicateur n'est pas dessiné lorsque l'utilisateur clique sur dans le contrôle d'édition et donne le focus au contrôle.Si true, la bannière de caractère indicateur est dessiné même lorsque le contrôle a le focus. La bannière de caractère indicateur disparaît lorsque le démarrage de l'utilisateur à entrer le contrôle.
La valeur par défaut est false.
Valeur de retour
true si la méthode est réussie ; sinon false.
Notes
Cette méthode envoie le message d' EM_SETCUEBANNER , qui est décrit dans Kit de développement logiciel Windows. Pour plus d'informations, consultez la macro d' Edit_SetCueBannerTextFocused .
Configuration requise
en-tête : afxwin.h
Ce contrôle est pris en charge dans Windows XP et versions ultérieures.
Les spécifications supplémentaires pour cette méthode sont décrites dans Spécifications pour la génération des contrôles communs Windows Vista.
Exemple
L'exemple de code suivant illustre la méthode CEdit::SetCueBanner.
m_cedit.SetCueBanner(_T("First, enter text here..."), TRUE);