CComboBox::SetCueBanner
Legt den Hinweistext fest, der für ein Kombinationsfeld-Steuerelement angezeigt wird.
BOOL SetCueBanner(
LPCTSTR lpszText
);
Parameter
Parameter |
Beschreibung |
---|---|
[in] lpszText |
Zeiger auf ein mit Null endende Puffer, der den Hinweistext enthält. |
Rückgabewert
true, wenn die Methode erfolgreich ist; andernfalls false.
Hinweise
Hinweistext ist eine Eingabeaufforderung, die im Eingabebereich des Kombinationsfeldsteuerelements angezeigt wird. Der Hinweistext wird angezeigt, wenn der Benutzer Eingabe bereitstellt.
Diese Methode sendet die CB_SETCUEBANNER Meldung, die im Windows SDK beschrieben wird.
Anforderungen
Header: afxwin.h
Diese Methode wird in Windows Vista und höher unterstützt.
Zusätzliche Anforderungen für diese Methode werden in Anforderungen für die Erstellung von Windows Vista-Standardsteuerelementen beschrieben.
Beispiel
Im folgenden Codebeispiel wird die Variable, m_combobox, die verwendet wird, um auf das Kombinationsfeld-Steuerelement programmgesteuert zuzugreifen. Diese Variable wird im folgenden Beispiel verwendet.
// Variable to access the combo box control
CComboBox m_combobox;
Im folgenden Codebeispiel wird das Hinweisbanner für das Kombinationsfeld-Steuerelement fest.
// 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.