Udostępnij za pośrednictwem


CComboBox::SetCueBanner

Ustawia tekst sygnalizacji, który jest wyświetlany w formancie pola kombi.

BOOL SetCueBanner(
     LPCTSTR lpszText
);

Parametry

Parametr

Opis

[w] lpszText

Wskaźnik do buforu zakończony zerem, zawierający tekst sygnalizacji.

Wartość zwracana

trueJeśli metoda jest pomyślne; w przeciwnym razie false.

Uwagi

Tekst sygnalizacji jest monit jest wyświetlany w obszarze wprowadzania formant pola kombi.Zostanie wyświetlony tekst sygnalizacji, dopóki użytkownik udostępnia dane wejściowe.

Metoda ta wysyła CB_SETCUEBANNER wiadomości, która jest opisana w Windows SDK.

Wymagania

Nagłówek: afxwin.h

Ta metoda jest obsługiwana w Windows Vista i później.

Dodatkowe wymagania dla tej metody opisane w Budowanie wymagania dla systemu Windows Vista wspólnej kontroli.

Przykład

Poniższy przykład kodu definiuje zmienną, m_combobox, że jest używany do programowego dostępu formant pola kombi.Ta zmienna jest używana w następnym przykładzie.

    // Variable to access the combo box control
    CComboBox m_combobox;

Poniższy kod ustawia transparent sygnalizacji na formant pola kombi.

    // 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.

Zobacz też

Informacje

Klasa CComboBox

Wykres hierarchii

CComboBox::GetCueBanner

CB_SETCUEBANNER