CMFCToolBarComboBoxButton (clase)

Artículo
06/16/2023

Botón de la barra de herramientas que contiene un control de cuadro combinado (CComboBox Class).

Sintaxis

class CMFCToolBarComboBoxButton : public CMFCToolBarButton

Miembros

Constructores públicos

Nombre	Descripción
CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton	Construye un objeto `CMFCToolBarComboBoxButton`.

Métodos públicos

Nombre	Descripción
CMFCToolBarComboBoxButton::AddItem	Agrega un elemento al final de la lista de los cuadros combinados.
CMFCToolBarComboBoxButton::AddSortedItem	Agrega un elemento a la lista de cuadros combinados. El orden de los elementos de la lista se especifica mediante `Compare`.
CMFCToolBarComboBoxButton::Compare	Compara dos elementos. Se llama para ordenar los elementos que agrega `AddSortedItems` a la lista de cuadros combinados.
CMFCToolBarComboBoxButton::CreateEdit	Crea un nuevo control de edición para el botón de cuadro combinado.
CMFCToolBarComboBoxButton::DeleteItem	Elimina un elemento de la lista de cuadros combinados.
CMFCToolBarComboBoxButton::FindItem	Devuelve el índice del elemento que contiene una cadena especificada.
CMFCToolBarComboBoxButton::GetByCmd	Devuelve un puntero al botón de cuadro combinado con un id. del comando especificado.
CMFCToolBarComboBoxButton::GetComboBox	Devuelve un puntero al control de cuadro combinado incrustado en el botón del cuadro combinado.
CMFCToolBarComboBoxButton::GetCount	Devuelve el número de elementos de la lista de cuadros combinados.
CMFCToolBarComboBoxButton::GetCountAll	Busca el botón del cuadro combinado que tiene un id. del comando especificado. Devuelve el número de elemento de la lista de cuadros combinados del botón.
CMFCToolBarComboBoxButton::GetCurSel	Devuelve el índice del elemento seleccionado en la lista de cuadros combinados.
CMFCToolBarComboBoxButton::GetCurSelAll	Busca el botón del cuadro combinado con un id. de comando especificado y devuelve el índice del elemento seleccionado en la lista de cuadros combinados de ese botón.
CMFCToolBarComboBoxButton::GetEditCtrl	Devuelve un puntero al control de edición incrustado en el botón del cuadro combinado.
CMFCToolBarComboBoxButton::GetItem	Devuelve la cadena asociada a un índice especificado en la lista de cuadros combinados.
CMFCToolBarComboBoxButton::GetItemAll	Busca el botón del cuadro combinado con un id. de comando especificado y devuelve la cadena asociada al índice en la lista de cuadros combinados de ese botón.
CMFCToolBarComboBoxButton::GetItemData	Devuelve el valor de 32 bits asociado a un índice especificado en la lista de cuadros combinados.
CMFCToolBarComboBoxButton::GetItemDataAll	Busca el botón del cuadro combinado con un id. de comando especificado y devuelve el valor de 32 bits asociado al índice en la lista de cuadros combinados de ese botón.
CMFCToolBarComboBoxButton::GetItemDataPtrAll	Busca el botón del cuadro combinado que tiene un id. del comando especificado. Recupera el valor de 32 bits asociado a un índice de la lista de cuadros combinados de ese botón y devuelve el valor de 32 bits como puntero.
CMFCToolBarComboBoxButton::GetText	Devuelve el texto del control de edición del cuadro combinado.
CMFCToolBarComboBoxButton::GetTextAll	Busca el botón de cuadro combinado con un id. de comando especificado y devuelve el texto del control de edición de ese botón.
CMFCToolBarComboBoxButton::IsCenterVert	Establece si los botones de cuadro combinado de la aplicación están centrados o alineados con la parte superior de la barra de herramientas.
CMFCToolBarComboBoxButton::IsFlatMode	Establece si la apariencia de los botones de cuadro combinado de la aplicación es plana.
CMFCToolBarComboBoxButton::RemoveAllItems	Quita todos los elementos del cuadro de lista y el control de edición del cuadro combinado.
CMFCToolBarComboBoxButton::SelectItem	Selecciona un elemento del cuadro combinado en función de su índice, valor de 32 bits o cadena y notifica al control de cuadro combinado sobre la selección.
CMFCToolBarComboBoxButton::SelectItemAll	Busca el botón del cuadro combinado que tiene un id. del comando especificado. Llama a `SelectItem` para seleccionar un elemento del cuadro combinado de ese botón en función de la cadena, índice o valor de 32 bits.
CMFCToolBarComboBoxButton::SetCenterVert	Especifica si los botones de cuadro combinado de la aplicación están centrados verticalmente o alineados con la parte superior de la barra de herramientas.
CMFCToolBarComboBoxButton::SetDropDownHeight	Establece el alto del cuadro de lista desplegable.
CMFCToolBarComboBoxButton::SetFlatMode	Especifica si la apariencia de los botones de cuadro combinado de la aplicación es plana.

Comentarios

Para agregar un botón del cuadro combinado a una barra de herramientas, siga estos pasos:

Reserve un id. de recurso ficticio para el botón en el recurso primario de la barra de herramientas.
Cree un objeto CMFCToolBarComboBoxButton.
En el controlador de mensajes que procesa el mensaje de AFX_WM_RESETTOOLBAR, reemplace el botón ficticio por el nuevo botón del cuadro combinado mediante CMFCToolBar::ReplaceButton.

Para más información, consulte Tutorial: Colocación de controles en las barras de herramientas. Consulte el proyecto de ejemplo VisualStudioDemo para ver una muestra de un botón de la barra de herramientas de cuadro combinado.

Ejemplo

En el siguiente ejemplo se muestra cómo usar los distintos métodos en la clase CMFCToolBarComboBoxButton . En el ejemplo se explica cómo se pueden habilitar los cuadros combinados y edición, establecer la posición vertical de los botones del cuadro combinado de la aplicación, definir el alto del cuadro de lista al desplegarse, establecer el estilo plano de los botones del cuadro combinado de la aplicación y definir el texto en el cuadro de edición del botón del cuadro combinado. Este fragmento de código forma parte del ejemplo de demostración de Visual Studio.

// CObList listButtons
// POSITION posCombo
CMFCToolBarComboBoxButton* pCombo = DYNAMIC_DOWNCAST(CMFCToolBarComboBoxButton, listButtons.GetNext(posCombo));

pCombo->EnableWindow(true);
pCombo->SetCenterVert();
pCombo->SetDropDownHeight(25);
pCombo->SetFlatMode();
pCombo->SetText(_T("this is a combo box"));

Jerarquía de herencia

CObject

CMFCToolBarButton

CMFCToolBarComboBoxButton

Requisitos

Encabezado: afxtoolbarcomboboxbutton.h

CMFCToolBarComboBoxButton::AddItem

Anexa un elemento único al cuadro de lista.

virtual INT_PTR AddItem(
    LPCTSTR lpszItem,
    DWORD_PTR dwData=0);

Parámetros

lpszItem
[in] Texto del elemento que se va a agregar al cuadro de lista.

dwData
[in] Datos asociados al elemento que se va a agregar al cuadro de lista.

Valor devuelto

Índice del último elemento del cuadro de lista.

Comentarios

No use este método cuando el estilo del cuadro de lista está ordenado.

Si el texto del elemento ya está en el cuadro de lista, los nuevos datos se almacenan con el elemento existente. En la búsqueda del elemento se distinguen mayúsculas de minúsculas.

CMFCToolBarComboBoxButton::AddSortedItem

Agrega un elemento al cuadro de lista en el orden definido por el método Compare.

virtual INT_PTR AddSortedItem(
    LPCTSTR lpszItem,
    DWORD_PTR dwData=0);

Parámetros

lpszItem
[in] Texto del elemento que se va a agregar al cuadro de lista.

dwData
[in] Datos asociados al elemento que se va a agregar al cuadro de lista.

Valor devuelto

Índice del elemento que se agregó al cuadro de lista.

Comentarios

Use esta función para agregar elementos al cuadro de lista en un orden determinado.

CMFCToolBarComboBoxButton::CanBeStretched

Indica si se puede cambiar el tamaño del botón del cuadro combinado.

virtual BOOL CanBeStretched() const;

Valor devuelto

Devuelve TRUE.

CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton

Construye un objeto CMFCToolBarComboBoxButton.

CMFCToolBarComboBoxButton(
    UINT uiID,
    int iImage,
    DWORD dwStyle=CBS_DROPDOWNLIST,
    int iWidth=0);

Parámetros

uiID
[in] Id. de comando del nuevo botón.

iImage
[in] Índice de imagen de la imagen asociada al nuevo botón.

dwStyle
[in] Estilo del nuevo botón.

iWidth
[in] Ancho en píxeles del nuevo botón.

Comentarios

El ancho predeterminado es 150 píxeles.

Consulte Estilos de control ToolBar para obtener una lista de estilos de botón de la barra de herramientas

CMFCToolBarComboBoxButton::ClearData

Elimina los datos definidos por el usuario.

virtual void ClearData();

Comentarios

De forma predeterminada, este método no hace nada. Invalide este método en una clase derivada para eliminar los datos definidos por el usuario.

CMFCToolBarComboBoxButton::Compare

Compara dos cadenas.

virtual int Compare(
    LPCTSTR lpszItem1,
    LPCTSTR lpszItem2);

Parámetros

lpszItem1
[in] Primera cadena que se va a comparar.

lpszItem2
[in] Segunda cadena que se va a comparar.

Valor devuelto

Valor que indica la relación lexicográfica y que distingue mayúsculas de minúsculas que existe entre las cadenas. En la tabla siguiente, se ofrecen los valores posibles:

Valor	Descripción
<0	Si la primera cadena es menor que la segunda.
0	La primera cadena es igual a la segunda.
>0	La primera cadena es mayor que la segunda.

Comentarios

Invalide este método para cambiar el orden de los elementos del cuadro de lista.

En la comparación se distinguen mayúsculas de minúsculas.

Solo se llama a este método desde el método AddSortedItem.

CMFCToolBarComboBoxButton::CopyFrom

Copia el estado del objeto especificado CMFCToolBarComboBoxButton en el objeto actual.

virtual void CopyFrom(const CMFCToolBarButton& src);

Parámetros

src
[in] El objeto CMFCToolBarComboBoxButton de origen.

CMFCToolBarComboBoxButton::CreateCombo

Crea un nuevo cuadro combinado para el botón de cuadro combinado.

virtual CComboBox* CreateCombo(
    CWnd* pWndParent,
    const CRect& rect);

Parámetros

pWndParent
[in] Puntero que apunta a la ventana primaria del botón.

rect
[in] Rectángulo delimitador del cuadro combinado.

Valor devuelto

Puntero que apunta al nuevo cuadro combinado si el método se aplicó correctamente, en caso contrario NULL.

CMFCToolBarComboBoxButton::CreateEdit

Crea un nuevo cuadro de edición para el botón de cuadro combinado.

virtual CMFCToolBarComboBoxEdit* CreateEdit(
    CWnd* pWndParent,
    const CRect& rect,
    DWORD dwEditStyle);

Parámetros

pWndParent
[in] Puntero que apunta a la ventana primaria del botón.

rect
[in] Rectángulo delimitador del nuevo cuadro de edición.

dwEditStyle
[in] Estilo de control del nuevo cuadro de edición.

Valor devuelto

Puntero al nuevo cuadro de edición si el método se aplicó correctamente, en caso contrario NULL.

Comentarios

El marco llama a este método cuando crea un nuevo cuadro de edición para un botón de cuadro combinado. Invalide este método si desea cambiar cómo se crea CMFCToolBarComboBoxEdit.

CMFCToolBarComboBoxButton::DeleteItem

Elimina un elemento especificado del cuadro de lista.

BOOL DeleteItem(int iIndex);
BOOL DeleteItem(DWORD_PTR dwData);
BOOL DeleteItem(LPCTSTR lpszText);

Parámetros

iIndex
[in] Índice de base cero del elemento que se va a eliminar.

dwData
[in] Datos asociados al elemento que se va a eliminar.

lpszText
[in] Texto del elemento que se va a eliminar. Si hay varios elementos con el mismo texto, se elimina el primero.

Valor devuelto

TRUE si se localizó y eliminó el elemento correctamente; de lo contrario, FALSE.

Comentarios

CMFCToolBarComboBoxButton::DuplicateData

Duplica los datos definidos por el usuario.

virtual void DuplicateData();

Comentarios

De forma predeterminada, este método no hace nada. Invalide este método en una clase derivada para copiar cualquier dato que ha definido el usuario.

CMFCToolBarComboBoxButton::EnableWindow

Habilita o deshabilita los cuadros combinados y de edición.

virtual void EnableWindow(BOOL bEnable = TRUE);

Parámetros

bEnable
[in] TRUE para habilitar los cuadros de edición y combinado; FALSE para deshabilitar los cuadros combinados y de edición.

Comentarios

Si están deshabilitados, los controles no se pueden activar y no pueden aceptar entradas de usuario.

CMFCToolBarComboBoxButton::ExportToMenuButton

Copia una cadena de la tabla de cadena de la aplicación a un menú especificado con el id. de comando del botón del cuadro combinado.

virtual BOOL ExportToMenuButton(CMFCToolBarMenuButton& menuButton) const;

Parámetros

menuButton
[out] Referencia a un botón del menú.

Valor devuelto

Siempre TRUE.

CMFCToolBarComboBoxButton::FindItem

Devuelve el índice del primer elemento del cuadro de lista que contiene una cadena especificada.

int FindItem(LPCTSTR lpszText) const;

Parámetros

lpszText
[in] Texto para el que se va a buscar en el cuadro de lista.

Valor devuelto

El índice del elemento o, si no se encuentra, CB_ERR.

Comentarios

CMFCToolBarComboBoxButton::GetByCmd

Obtiene un puntero que apunta al botón de cuadro combinado con un identificador del comando especificado.

static CMFCToolBarComboBoxButton* GetByCmd(
    UINT uiCmd,
    BOOL bIsFocus=FALSE);

Parámetros

uiCmd
[in] Id. de comando de un botón de cuadro combinado.

bIsFocus
[in] TRUE para buscar solo botones centrados; FALSE para buscar todo tipo de botones.

Valor devuelto

Puntero que apunta a un botón del cuadro combinado; o NULL si no se encuentra el botón.

Comentarios

CMFCToolBarComboBoxButton::GetComboBox

Devuelve un puntero que apunta al cuadro combinado del botón del cuadro combinado.

CComboBox* GetComboBox() const;

Valor devuelto

Puntero al objeto CComboBox Class si el método se aplicó correctamente; en caso contrario, NULL.

Comentarios

CMFCToolBarComboBoxButton::GetContextMenuID

Obtiene el id. del recurso del menú contextual para el botón del cuadro combinado.

UINT GetContextMenuID();

Valor devuelto

Id. del recurso del menú contextual.

CMFCToolBarComboBoxButton::GetCount

Devuelve el número de elementos en el cuadro de lista.

INT_PTR GetCount() const;

Valor devuelto

Número de elementos en el cuadro de lista.

Comentarios

CMFCToolBarComboBoxButton::GetCountAll

Obtiene el número de elementos del cuadro de lista de un botón de cuadro combinado que tiene un id. de comando especificado.

static int GetCountAll(UINT uiCmd);

Parámetros

uiCmd
[in] Id. de comando de un botón de cuadro combinado.

Valor devuelto

Número de elementos del cuadro de lista; de lo contrario, CB_ERR si no se encuentra el botón de cuadro combinado.

Comentarios

CMFCToolBarComboBoxButton::GetCurSel

Obtiene el índice del elemento seleccionado actualmente en el cuadro de lista.

int GetCurSel() const;

Valor devuelto

El índice del elemento seleccionado en ese momento en el cuadro de lista; o CB_ERR si no se selecciona ningún elemento.

Comentarios

El índice del cuadro de lista se basa en cero.

CMFCToolBarComboBoxButton::GetCurSelAll

Devuelve el índice del elemento seleccionado en ese momento del cuadro de lista del botón de cuadro combinado que tiene un id. de comando especificado.

static int GetCurSelAll(UINT uiCmd);

Parámetros

uiCmd
[in] Id. de comando de un botón de cuadro combinado.

Valor devuelto

Índice del elemento seleccionado en ese momento del cuadro de lista; de lo contrario, CB_ERR si no se selecciona ningún elemento o no se encuentra un botón de cuadro combinado.

Comentarios

El índice del cuadro de lista se basa en cero.

CMFCToolBarComboBoxButton::GetEditCtrl

Devuelve un puntero que apunta al cuadro de edición del botón del cuadro combinado.

virtual CEdit* GetEditCtrl();

Valor devuelto

Puntero al cuadro de edición si el método se aplicó correctamente, en caso contrario NULL.

Comentarios

CMFCToolBarComboBoxButton::GetHwnd

Devuelve el identificador de ventana del cuadro combinado.

virtual HWND GetHwnd();

Valor devuelto

Identificador de ventana o NULL si el cuadro combinado no está asociado a un objeto de ventana.

CMFCToolBarComboBoxButton::GetItem

Devuelve la cadena asociada con un elemento en un índice especificado en el cuadro de lista.

LPCTSTR GetItem(int iIndex=-1) const;

Parámetros

iIndex
[in] Índice de base cero de un elemento en el cuadro de lista.

Valor devuelto

Puntero a la cadena asociada al elemento; de lo contrario, NULL si el parámetro de índice no es válido o si el parámetro de índice es -1 y no hay ningún elemento seleccionado en el cuadro combinado.

Comentarios

Un parámetro de índice de -1 devuelve la cadena del elemento seleccionado en ese momento.

CMFCToolBarComboBoxButton::GetItemAll

Devuelve la cadena asociada a un elemento de un índice especificado en el cuadro de lista de un botón de cuadro combinado que tiene un id. de comando especificado.

static LPCTSTR GetItemAll(
    UINT uiCmd,
    int iIndex=-1);

Parámetros

uiCmd
[in] Id. de comando de un botón de cuadro combinado.

iIndex
[in] Índice de base cero de un elemento en el cuadro de lista.

Valor devuelto

Puntero a la cadena del elemento si el método se aplicó correctamente; de lo contrario, NULL si el índice no es válido, no se encuentra un botón de cuadro combinado o si el índice es -1 y no se ha seleccionado un elemento en el cuadro combinado.

Comentarios

Un valor de índice de -1 devuelve la cadena del elemento seleccionado en ese momento.

CMFCToolBarComboBoxButton::GetItemData

Devuelve la cadena asociada a un elemento en un índice especificado en el cuadro de lista.

DWORD_PTR GetItemData(int iIndex=-1) const;

Parámetros

iIndex
[in] Índice de base cero de un elemento en el cuadro de lista.

Valor devuelto

Datos asociados al elemento o 0 si el elemento no existe.

Comentarios

Un parámetro de índice de -1 devuelve los datos asociados al elemento seleccionado en ese momento.

CMFCToolBarComboBoxButton::GetItemDataAll

Devuelve los datos asociados a un elemento de un índice especificado en el cuadro de lista de un botón de cuadro combinado que tiene un id. de comando especificado.

static DWORD_PTR GetItemDataAll(
    UINT uiCmd,
    int iIndex=-1);

Parámetros

uiCmd
[in] Id. de comando de un botón de cuadro combinado.

iIndex
[in] Índice de base cero de un elemento en el cuadro de lista.

Valor devuelto

Los datos asociados al elemento si el método se aplicó correctamente; de lo contrario, 0 si el índice especificado no es válido o CB_ERR si no se encuentra el botón del cuadro combinado.

Comentarios

Un parámetro de índice de -1 devuelve los datos asociados al elemento seleccionado en ese momento.

CMFCToolBarComboBoxButton::GetItemDataPtrAll

Devuelve los datos asociados a un elemento de un índice especificado en el cuadro de lista de un botón de cuadro combinado que tiene un id. de comando especificado. Estos datos se devuelven como un puntero.

static void* GetItemDataPtrAll(
    UINT uiCmd,
    int iIndex=-1);

Parámetros

uiCmd
[in] Id. del comando del botón del cuadro combinado.

iIndex
[in] Índice de base cero de un elemento en el cuadro de lista.

Valor devuelto

Puntero asociado al elemento si el método se aplicó correctamente; de lo contrario, -1 si se produce un error o NULL si no se encuentra el botón de cuadro combinado.

Comentarios

CMFCToolBarComboBoxButton::GetPrompt

Devuelve la cadena de solicitud del botón de cuadro combinado.

virtual CString GetPrompt() const;

Valor devuelto

Cadena del símbolo del sistema.

Comentarios

Este método no está implementado actualmente.

CMFCToolBarComboBoxButton::GetText

Obtiene el texto del cuadro de edición.

LPCTSTR GetText() const;

Valor devuelto

Texto del cuadro de edición.

Comentarios

CMFCToolBarComboBoxButton::GetTextAll

Obtiene el texto del cuadro de edición de un botón de cuadro combinado con un id. de comando especificado.

static LPCTSTR GetTextAll(UINT uiCmd);

Parámetros

uiCmd
[in] Id. de comando de un botón de cuadro combinado específico.

Valor devuelto

Texto en el cuadro de edición si el método se aplicó correctamente, en caso contrario NULL.

Comentarios

CMFCToolBarComboBoxButton::HasFocus

Indica si el cuadro combinado tiene en ese momento el foco.

virtual BOOL HasFocus() const;

Valor devuelto

TRUE si el cuadro combinado tiene en ese momento el foco; de lo contrario, FALSE.

Comentarios

Este método también devuelve TRUE si una ventana secundaria del cuadro combinado tiene en ese momento el foco.

CMFCToolBarComboBoxButton::IsCenterVert

Devuelve la posición vertical de los botones de cuadro combinado de la aplicación.

static BOOL IsCenterVert();

Valor devuelto

TRUE si los botones están centrados; FALSE si los botones están alineados en la parte superior.

Comentarios

CMFCToolBarComboBoxButton::IsFlatMode

Devuelve la apariencia de estilo plano de los botones del cuadro combinado en la aplicación.

static BOOL IsFlatMode();

Valor devuelto

TRUE si los botones tienen un estilo plano; de lo contrario, FALSE.

Comentarios

El estilo plano predeterminado de los botones de cuadro combinado es FALSE.

CMFCToolBarComboBoxButton::IsOwnerOf

Indica si el id. especificado está asociado al botón de cuadro combinado o a uno de sus elementos secundarios.

virtual BOOL IsOwnerOf(HWND hwnd);

Parámetros

hwnd
[in] Identificador de ventana.

Valor devuelto

TRUE si el identificador está asociado al botón del cuadro combinado o uno de sus elementos secundarios; de lo contrario, FALSE.

CMFCToolBarComboBoxButton::IsRibbonButton

Indica si el botón del cuadro combinado se encuentra en un panel de cinta de opciones.

BOOL IsRibbonButton() const;

Valor devuelto

Siempre FALSE.

Comentarios

De forma predeterminada, este método devuelve siempre FALSE, lo que significa que el botón del cuadro combinado no se muestra nunca en un panel de cinta de opciones.

CMFCToolBarComboBoxButton::IsWindowVisible

Devuelve el estado de visibilidad del botón del cuadro combinado.

virtual BOOL IsWindowVisible();

Valor devuelto

Estado de visibilidad del botón del cuadro combinado.

CMFCToolBarComboBoxButton::NotifyCommand

Indica si el botón del cuadro combinado procesa el mensaje.

virtual BOOL NotifyCommand(int iNotifyCode);

Parámetros

iNotifyCode
[in] El mensaje de notificación asociado al comando.

Valor devuelto

Si el botón del cuadro combinado procesa el mensaje.

CMFCToolBarComboBoxButton::OnAddToCustomizePage

Lo llama el marco cuando se agrega el botón al cuadro de diálogo Personalizar.

virtual void OnAddToCustomizePage();

CMFCToolBarComboBoxButton::OnCalculateSize

Lo llama el marco para calcular el tamaño del botón.

virtual SIZE OnCalculateSize(
    CDC* pDC,
    const CSize& sizeDefault,
    BOOL bHorz);

Parámetros

pDC
[in] Contexto de dispositivo que muestra el botón del cuadro combinado.

sizeDefault
[in] Tamaño predeterminado del botón del cuadro combinado.

bHorz
[in] Estado de acoplamiento de la barra de herramientas primaria. TRUE cuando la barra de herramientas está acoplada horizontalmente y FALSE cuando está acoplada verticalmente.

Valor devuelto

Estructura SIZE que contiene las dimensiones en píxeles del botón del cuadro combinado.

CMFCToolBarComboBoxButton::OnChangeParentWnd

Lo llama el marco cuando el botón del cuadro combinado se inserta en una nueva barra de herramientas.

virtual void OnChangeParentWnd(CWnd* pWndParent);

Parámetros

pWndParent
[in] Puntero a la nueva barra de herramientas.

CMFCToolBarComboBoxButton::OnClick

Lo llama el marco de trabajo cuando el usuario hace clic en el botón del cuadro combinado.

virtual BOOL OnClick(
    CWnd* pWnd,
    BOOL bDelay = TRUE);

Parámetros

pWnd
[in] Puntero a la ventana primaria del botón del cuadro combinado.

bDelay
[in] Reservado para su uso en una clase derivada.

Valor devuelto

TRUE si el método controla el evento; de lo contrario, FALSE.

CMFCToolBarComboBoxButton::OnCtlColor

Lo llama el marco si el usuario cambia el color de la barra de herramientas principal para establecer el color del botón del cuadro combinado.

virtual HBRUSH OnCtlColor(
    CDC* pDC,
    UINT nCtlColor);

Parámetros

pDC
[in] Contexto de dispositivo que muestra el botón del cuadro combinado.

nCtlColor
[in] Sin utilizar.

Valor devuelto

Identificador del objeto brush que el marco utiliza para pintar el fondo del botón del cuadro combinado.

Comentarios

Mediante este método también se establece el color de texto del botón de cuadro combinado.

CMFCToolBarComboBoxButton::OnDraw

Lo llama el marco para dibujar el botón del cuadro combinado mediante las opciones y los estilos especificados.

virtual void OnDraw(
    CDC* pDC,
    const CRect& rect,
    CMFCToolBarImages* pImages,
    BOOL bHorz = TRUE,
    BOOL bCustomizeMode = FALSE,
    BOOL bHighlight = FALSE,
    BOOL bDrawBorder = TRUE,
    BOOL bGrayDisabledButtons = TRUE);

Parámetros

Pdc
[in] Contexto de dispositivo que muestra el botón.

rect
[in] Rectángulo delimitador del botón.

pImages
[in] Colección de imágenes asociada al botón.

bHorz
[in] Estado de acoplamiento de la barra de herramientas primaria. TRUE cuando la barra de herramientas está acoplada horizontalmente y FALSE cuando está acoplada verticalmente.

bCustomizeMode
[in] Indica si la aplicación está en modo de personalización.

bHighlight
[in] Indica si se va a dibujar el botón de cuadro combinado resaltado.

bDrawBorder
[in] Indica si se va a dibujar el botón de cuadro combinado con un borde.

bGrayDisabledButtons
[in] TRUE para dibujar los botones sombreados deshabilitados; FALSE para emplear la colección de imágenes deshabilitadas.

CMFCToolBarComboBoxButton::OnDrawOnCustomizeList

Lo llama el marco para dibujar el botón de cuadro combinado en el panel Comandos del cuadro de diálogo Personalizar.

virtual int OnDrawOnCustomizeList(
    CDC* pDC,
    const CRect& rect,
    BOOL bSelected);

Parámetros

pDC
[in] Contexto de dispositivo que muestra el botón del cuadro combinado.

rect
[in] Rectángulo delimitador del botón del cuadro combinado.

bSelected
[in] TRUE si se selecciona el botón del cuadro combinado; de lo contrario, FALSE.

Valor devuelto

El ancho, en píxeles, del cuadro combinado.

CMFCToolBarComboBoxButton::OnGlobalFontsChanged

Lo llama el marco para establecer la fuente del botón del cuadro combinado al cambiar la fuente de la aplicación.

virtual void OnGlobalFontsChanged();

CMFCToolBarComboBoxButton::OnMove

Lo llama el marco para cambiar la ubicación del botón del cuadro combinado al moverse la barra de herramientas primaria.

virtual void OnMove();

CMFCToolBarComboBoxButton::OnShow

Lo llama el marco cuando se oculta o se muestra el botón del cuadro combinado.

virtual void OnShow(BOOL bShow);

Parámetros

bShow
[in] Indica si se va a ocultar o mostrar el botón del cuadro combinado.

CMFCToolBarComboBoxButton::OnSize

Lo llama el marco para cambiar el tamaño del botón del cuadro combinado cuando se cambia el tamaño de la barra de herramientas primaria.

virtual void OnSize(int iSize);

Parámetros

iSize
[in] Nuevo ancho del botón del cuadro combinado.

CMFCToolBarComboBoxButton::OnUpdateToolTip

Lo llama el marco cuando se cambia la sugerencia de herramientas para el botón del cuadro combinado.

virtual BOOL OnUpdateToolTip(
    CWnd* pWndParent,
    int iButtonIndex,
    CToolTipCtrl& wndToolTip,
    CString& str);

Parámetros

pWndParent
[in] Puntero a la ventana primaria del botón del cuadro combinado.

iButtonIndex
[in] Id. del botón del cuadro combinado.

wndToolTip
[in] Información sobre herramientas que se va a asociar con el botón del cuadro combinado.

str
[in] Texto de la información sobre herramientas.

Valor devuelto

TRUE si el método controla el evento; de lo contrario, FALSE.

CMFCToolBarComboBoxButton::RemoveAllItems

Elimina todos los elementos de la lista y los cuadros de edición.

void RemoveAllItems();

Comentarios

Quita todos los elementos del cuadro de lista y el control de edición de un cuadro combinado.

CMFCToolBarComboBoxButton::SelectItem

Selecciona un elemento en el cuadro de lista.

BOOL SelectItem(
    int iIndex,
    BOOL bNotify=TRUE);

BOOL SelectItem(DWORD_PTR dwData);
BOOL SelectItem(LPCTSTR lpszText);

Parámetros

iIndex
[in] Índice de base cero de un elemento en el cuadro de lista.

bNotify
[in] TRUE para notificar al botón del cuadro combinado de la selección; en caso contrario, FALSE.

dwData
[in] Los datos asociados a un elemento en el cuadro de lista.

lpszText
[in] Texto de un elemento en el cuadro de lista.

Valor devuelto

TRUE si el método se aplicó correctamente; de lo contrario, FALSE.

Comentarios

CMFCToolBarComboBoxButton::SelectItemAll

Selecciona un elemento del cuadro de lista de un botón de cuadro combinado que tiene un id. de comando especificado.

static BOOL SelectItemAll(
    UINT uiCmd,
    int iIndex);

static BOOL SelectItemAll(
    UINT uiCmd,
    DWORD_PTR dwData);

static BOOL SelectItemAll(
    UINT uiCmd,
    LPCTSTR lpszText);

Parámetros

uiCmd
[in] Id. de comando del botón del cuadro combinado que contiene el cuadro de lista.

iIndex
[in] Índice de base cero del elemento en el cuadro de lista. Valor de -1 quita cualquier selección activa en ese momento del cuadro de lista y borra el cuadro de edición.

dwData
[in] Datos de un elemento en el cuadro de lista.

lpszText
[in] Texto de un elemento en el cuadro de lista.

Valor devuelto

TRUE si el método se aplicó correctamente; de lo contrario, FALSE.

Comentarios

CMFCToolBarComboBoxButton::Serialize

Lee este objeto desde un archivo o lo escribe en un archivo.

virtual void Serialize(CArchive& ar);

Parámetros

Ar
[in, out] Objeto CArchive que se va a serializar.

Comentarios

La configuración del objeto CArchive determina si este método lee o escribe en el archivo.

CMFCToolBarComboBoxButton::SetACCData

Rellena el objeto CAccessibilityData especificado mediante los datos de accesibilidad del botón del cuadro combinado.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

Parámetros

pParent
[in] Ventana primaria del botón del cuadro combinado.

data
[out] Un objeto CAccessibilityData que recibe los datos de accesibilidad procedentes del botón del cuadro combinado.

Valor devuelto

TRUE si el método se aplicó correctamente; de lo contrario, FALSE.

CMFCToolBarComboBoxButton::SetCenterVert

Establece la posición vertical de los botones de cuadro combinado de la aplicación.

static void SetCenterVert(BOOL bCenterVert=TRUE);

Parámetros

bCenterVert
[in] TRUE para centrar el botón del cuadro combinado en la barra de herramientas; FALSE para alinear el botón del cuadro combinado en la parte superior de la barra de herramientas.

Comentarios

De forma predeterminada, los botones del cuadro combinado se alinean en la parte superior.

CMFCToolBarComboBoxButton::SetContextMenuID

Establece el id. del recurso del menú contextual para el botón del cuadro combinado.

void SetContextMenuID(UINT uiResID);

Parámetros

uiResID
[in] Id. del recurso del menú contextual.

CMFCToolBarComboBoxButton::SetDropDownHeight

Establece la altura del cuadro de lista cuando se despliega.

void SetDropDownHeight(int nHeight);

Parámetros

nHeight
[in] Altura, en píxeles, del cuadro de lista.

Comentarios

La altura predeterminada es de 150 píxeles.

CMFCToolBarComboBoxButton::SetFlatMode

Establece la apariencia de estilo plano de los botones del cuadro combinado en la aplicación.

static void SetFlatMode(BOOL bFlat=TRUE);

Parámetros

bFlat
[in] TRUE para una apariencia de estilo plano; en caso contrario, FALSE.

Comentarios

El estilo plano predeterminado de los botones de cuadro combinado es FALSE.

CMFCToolBarComboBoxButton::SetStyle

Establece el estilo especificado del botón del cuadro combinado y vuelve a dibujar el control si no está deshabilitado.

virtual void SetStyle(UINT nStyle);

Parámetros

nStyle
[in] Combinación bit a bit (OR) de estilos de barra de herramientas.

Comentarios

Consulte Estilos de control ToolBar para obtener una lista de estilos de botón de la barra de herramientas

CMFCToolBarComboBoxButton::SetText

Establece el texto en el cuadro de edición del botón cuadro combinado.

void SetText(LPCTSTR lpszText);

Parámetros

lpszText
[in] Puntero que apunta a una cadena que contiene el texto del cuadro de edición.

Consulte también

Gráfico de jerarquías
Clases
CMFCToolBarButton (clase)
CComboBox (clase)
CMFCToolBar::ReplaceButton
Tutorial: Poner controles en las barras de herramientas

Compartir a través de

CMFCToolBarComboBoxButton (clase)

Sintaxis

Miembros

Constructores públicos

Métodos públicos

Comentarios

Ejemplo

Jerarquía de herencia

Requisitos

CMFCToolBarComboBoxButton::AddItem

Parámetros

Valor devuelto

Comentarios

CMFCToolBarComboBoxButton::AddSortedItem

Parámetros

Valor devuelto

Comentarios

CMFCToolBarComboBoxButton::CanBeStretched

Valor devuelto

CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton

Parámetros

Comentarios

CMFCToolBarComboBoxButton::ClearData

Comentarios

CMFCToolBarComboBoxButton::Compare

Parámetros

Valor devuelto

Comentarios

CMFCToolBarComboBoxButton::CopyFrom

Parámetros

CMFCToolBarComboBoxButton::CreateCombo

Parámetros

Valor devuelto

CMFCToolBarComboBoxButton::CreateEdit

Parámetros

Valor devuelto

Comentarios

CMFCToolBarComboBoxButton::DeleteItem

Parámetros

Valor devuelto

Comentarios

CMFCToolBarComboBoxButton::DuplicateData

Comentarios

CMFCToolBarComboBoxButton::EnableWindow

Parámetros

Comentarios

CMFCToolBarComboBoxButton::ExportToMenuButton

Parámetros

Valor devuelto

CMFCToolBarComboBoxButton::FindItem

Parámetros

Valor devuelto

Comentarios

CMFCToolBarComboBoxButton::GetByCmd

Parámetros

Valor devuelto

Comentarios

CMFCToolBarComboBoxButton::GetComboBox

Valor devuelto

Comentarios

CMFCToolBarComboBoxButton::GetContextMenuID

Valor devuelto

CMFCToolBarComboBoxButton::GetCount

Valor devuelto

Comentarios

CMFCToolBarComboBoxButton::GetCountAll

Parámetros

Valor devuelto

Comentarios

CMFCToolBarComboBoxButton::GetCurSel

Valor devuelto

Comentarios

CMFCToolBarComboBoxButton::GetCurSelAll

Parámetros

Valor devuelto

Comentarios

CMFCToolBarComboBoxButton::GetEditCtrl

Valor devuelto

Comentarios