CComboBox::SetCueBanner
Nastaví startovací text, který se zobrazí pro ovládací prvek pole se seznamem.
BOOL SetCueBanner(
LPCTSTR lpszText
);
Parametry
Parametr |
Description |
|---|---|
[v] lpszText |
Ukazatel do vyrovnávací paměti zakončený hodnotou null, obsahující text startovací. |
Vrácená hodnota
trueJestliže je metoda úspěšná. jinak false .
Poznámky
Startovací text je dotaz, který se zobrazí ve vstupní oblasti ovládacího prvku pole se seznamem.Dokud poskytuje vstup uživatele, zobrazí se text startovací.
Tato metoda odesílá CB_SETCUEBANNER zprávy, která je popsána v .
Požadavky
Záhlaví: afxwin.h
Tato metoda je podporována v a novější.
Další požadavky této metody jsou popsány v Požadavky na sestavení pro běžné ovládací prvky systému Windows Vista.
Příklad
Následující příklad kódu definuje proměnné, m_combobox , se používá k programovému přístupu ovládací prvek pole se seznamem.Tato proměnná se používá v následujícím příkladu.
// Variable to access the combo box control
CComboBox m_combobox;
Následující kód například nastaví startovací nápis pro ovládací prvek pole se seznamem.
// 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.