Partager via


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);

Voir aussi

Référence

CEdit, classe

Graphique de la hiérarchie

CEdit::GetCueBanner

EM_SETCUEBANNER

Edit_SetCueBannerTextFocused