Compartir a través de


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 la compilación para 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.

Vea también

Referencia

Clase CComboBox

Gráfico de jerarquía

CComboBox::GetCueBanner

CB_SETCUEBANNER