Compartilhar via


CComboBox::SetCueBanner

Define o texto da indicação que é exibido em um controle caixa de combinação.

BOOL SetCueBanner(
     LPCTSTR lpszText
);

Parâmetros

Parâmetro

Descrição

[in] lpszText

Ponteiro para um buffer NULL- encerrado que contém o texto da indicação.

Valor de retorno

true se o método for bem-sucedida; caso contrário, false.

Comentários

O texto da indicação é um aviso que é exibido na área de entrada do controle de caixa combo.O texto da indicação é exibido até que o usuário fornece entrada.

Este método envia a mensagem de CB_SETCUEBANNER , que é descrita em Windows SDK.

Requisitos

Cabeçalho: afxwin.h

Este método é suportado em Windows Vista e posteriormente.

Os requisitos adicionais para o método são descritos em Criar requisitos de controles comuns do Windows Vista.

Exemplo

O exemplo de código a seguir define a variável, m_combobox, que é usada para acessar o controle por meio da caixa combo.Esta variável é usado no exemplo a seguir.

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

O exemplo de código a seguir define a faixa de indicação para o controle de caixa combo.

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

Consulte também

Referência

Classe de CComboBox

Gráfico de hierarquia

CComboBox::GetCueBanner

CB_SETCUEBANNER