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 Requisitos de compilação para 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.