CComboBox::SetCueBanner

Artigo
08/25/2010

Define o texto de sinalização que é exibido para um controle de caixa de combinação.

BOOL SetCueBanner(
          LPCTSTR lpszText
);

Parâmetros

Parâmetro	Descrição
[in] lpszText	Ponteiro para um buffer terminada com nulo que contém o texto de sinalização.

Valor de retorno

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

Comentários

Texto de sinalização é um aviso é exibido na área de entrada da caixa de combinação.O texto de indicação é exibido até que o usuário forneça uma entrada.

Esse método envia o CB_SETCUEBANNER mensagem, que é descrita no Windows SDK.

Requisitos

Cabeçalho: afxwin.h

Este método é suportado no Windows Vista e mais recente.

Requisitos adicionais para este método são descritos em compilação Requisitos para controles comuns do Windows Vista.

Exemplo

O exemplo de código a seguir define a variável, m_combobox, que é usado para acessar programaticamente o controle de caixa de combinação. Essa variável é usada 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 sinalização para o controle de caixa de combinação.

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