CComboBox::SetCueBanner
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.