CComboBox::SetCueBanner
Définit le texte de caractère indicateur restitué pour un contrôle zone de liste déroulante.
BOOL SetCueBanner(
LPCTSTR lpszText
);
Paramètres
Paramètre |
Description |
|---|---|
[in] lpszText |
Pointeur vers une mémoire tampon se terminant par null qui contient le texte de caractère indicateur. |
Valeur de retour
true si la méthode réussit ; sinon, false.
Notes
Le texte de caractère indication est une invite qui s'affiche dans le champ d'entrée de contrôle zone de liste déroulante.Le texte de caractère indicateur est affiché jusqu'à ce que l'utilisateur fournit des données.
Cette méthode envoie le message de CB_SETCUEBANNER , qui est décrit dans Kit de développement logiciel Windows.
Configuration requise
en-tête : afxwin.h
Cette méthode est prise en Windows Vista et versions ultérieures.
Les spécifications supplémentaires pour cette méthode sont décrites dans Spécifications de génération des contrôles communs Windows Vista.
Exemple
L'exemple de code suivant définit la variable, m_combobox, qui est utilisée pour accéder par programme le contrôle zone de liste déroulante.Cette variable est utilisée dans l'exemple suivant.
// Variable to access the combo box control
CComboBox m_combobox;
L'exemple de code suivant définit la bannière de caractère indicateur pour le contrôle zone de liste déroulante.
// Add extra initialization here.
// Add 20 items to the combo box. The Resource Editor
// has already been used to set the style of the combo
// box to CBS_SORT.
CString str;
for (int i = 1; i <= 20; i++)
{
str.Format(_T("Item %2d"), i);
m_combobox.AddString(str);
}
// Set the minimum visible item
m_combobox.SetMinVisibleItems( 10 );
// Set the cue banner
m_combobox.SetCueBanner(_T("Select an item..."));
// End of extra initialization.