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 Build-Anforderungen für Windows Vista-gemeinsame Regelungen 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.

Siehe auch

Referenz

CComboBox-Klasse

Hierarchien-Diagramm

CComboBox::GetCueBanner

CB_SETCUEBANNER