CComboBox::SetCueBanner
Establece el texto de señal que se muestra para un control de cuadro combinado.
BOOL SetCueBanner(
LPCTSTR lpszText
);
Parámetros
Parámetro |
Descripción |
|---|---|
[in] lpszText |
Puntero a un búfer terminado en null que contiene el texto de la señal. |
Valor devuelto
true si el método es correcto; en caso contrario, false.
Comentarios
El texto de la señal es un indicador que se muestra en el área de entrada de control combobox. Se muestra el texto de la señal hasta que el usuario su entrada.
Este método envía el mensaje de CB_SETCUEBANNER , que se describe en Windows SDK.
Requisitos
encabezado: afxwin.h
Este método se admite en Windows Vista y posterior.
los requisitos adicionales para este método se describen en Requisitos de compilación para los controles comunes de Windows Vista.
Ejemplo
El ejemplo de código siguiente define la variable, m_combobox, que se utiliza para obtener acceso mediante programación al control de cuadro combinado. esta variable se utiliza en el ejemplo siguiente.
// Variable to access the combo box control
CComboBox m_combobox;
El ejemplo de código siguiente establece el titular de señal para el control de cuadro combinado.
// 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.