CMFCRibbonComboBox Class

La clase CMFCRibbonComboBoximplementa un control de cuadro combinado que puede agregar a una barra de la cinta, un panel de la cinta o un menú emergente de la cinta.

Sintaxis

class CMFCRibbonComboBox : public CMFCRibbonEdit

Miembros

Constructores

Nombre	Descripción
CMFCRibbonComboBox::CMFCRibbonComboBox	Construye un objeto CMFCRibbonComboBox.

Métodos públicos

Nombre	Descripción
CMFCRibbonComboBox::AddItem	Anexa un elemento único al cuadro de lista.
CMFCRibbonComboBox::DeleteItem	Elimina un elemento especificado del cuadro de lista.
CMFCRibbonComboBox::EnableDropDownListResize	Especifica si el cuadro de lista puede cambiar el tamaño al desplegarse.
CMFCRibbonComboBox::FindItem	Devuelve el índice del primer elemento en el cuadro de lista que coincide con la cadena especificada.
CMFCRibbonComboBox::GetCount	Devuelve el número de elementos en el cuadro de lista.
CMFCRibbonComboBox::GetCurSel	Obtiene el índice del elemento seleccionado actualmente en el cuadro de lista.
CMFCRibbonComboBox::GetDropDownHeight	Obtiene la altura del cuadro de lista cuando se despliega el cuadro de lista.
CMFCRibbonComboBox::GetIntermediateSize	Devuelve el tamaño del cuadro combinado tal como se muestra en modo intermedio.
CMFCRibbonComboBox::GetItem	Devuelve la cadena asociada con un elemento en un índice especificado en el cuadro de lista.
CMFCRibbonComboBox::GetItemData	Devuelve la cadena asociada con un elemento en un índice especificado en el cuadro de lista.
CMFCRibbonComboBox::HasEditBox	Indica si el control contiene un cuadro de edición.
CMFCRibbonComboBox::IsResizeDropDownList	Indica si se puede cambiar o no el tamaño del cuadro de lista.
CMFCRibbonComboBox::OnSelectItem	Lo llama el marco cuando el usuario selecciona un elemento en el cuadro de lista.
CMFCRibbonComboBox::RemoveAllItems	Elimina todos los elementos del cuadro de lista y borra el cuadro de edición.
CMFCRibbonComboBox::SelectItem	Selecciona un elemento en el cuadro de lista.
CMFCRibbonComboBox::SetDropDownHeight	Establece la altura del cuadro de lista cuando se despliega.

Comentarios

El cuadro combinado de la cinta consta de un cuadro de lista combinado con una etiqueta estática o una etiqueta que el usuario puede editar. Debe especificar qué tipo desea al crear el cuadro combinado de la cinta.

Ejemplo

En el ejemplo siguiente se muestra cómo construir un objeto de la clase CMFCRibbonComboBox, agregar un elemento al cuadro combinado, seleccionar un elemento en el cuadro combinado y agregar un cuadro combinado a un panel.

// Create a simple combo box with two entries:
// The first parameter is the id of the combo box.
// The third parameter is the width of the combo box in pixels.
// The fourth parameter is the display label of the combo box.
// The fifth parameter is the index of the small image of the combo box.
CMFCRibbonComboBox *pComboSimple = new CMFCRibbonComboBox(-1, FALSE, -1, 0, -1);

// Add two items to the combo box and select the first item in the list:
pComboSimple->AddItem(_T("Hi!"));
pComboSimple->AddItem(_T("Hello!"));
pComboSimple->SelectItem(0);

// Add combo button to "Favorites" panel:
// CMFCRibbonPanel* pPanelFavorites
pPanelFavorites->Add(pComboSimple);

Jerarquía de herencia

CObject

CMFCRibbonBaseElement

CMFCRibbonButton

CMFCRibbonEdit

CMFCRibbonComboBox

Requisitos

Encabezado: afxribboncombobox.h

CMFCRibbonComboBox::AddItem

Anexa un elemento único al cuadro de lista.

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

Parámetros

lpszItem
[in] La cadena del elemento que se va a agregar.

dwData
[in] Los datos asociados con el elemento que se va a agregar.

Valor devuelto

El índice de base cero del elemento anexado.

CMFCRibbonComboBox::CMFCRibbonComboBox

Construye un objeto CMFCRibbonComboBox.

public:
CMFCRibbonComboBox(
    UINT nID,
    BOOL bHasEditBox=TRUE,
    Int nWidth=-1,
    LPCTSTR lpszLabel=NULL,
    Int nImage=-1);

protected:
CMFCRibbonComboBox();

Parámetros

Nid
[in] El id. del cuadro combinado.

bHasEditBox
[in] TRUE si desea un cuadro de edición dentro del control; FALSE en caso contrario.

nWidth
[in] Ancho del cuadro combinado en píxeles; o -1 para el ancho predeterminado.

lpszLabel
[in] La etiqueta de presentación del cuadro combinado.

nImage
[in] El índice de imagen pequeña del cuadro combinado.

Comentarios

El ancho predeterminado es 108 píxeles.

CMFCRibbonComboBox::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] La cadena del elemento que se va a eliminar. Si hay varios elementos con la misma cadena, se elimina el primer elemento.

Valor devuelto

TRUE si se ha eliminado el elemento especificado; de lo contrario, FALSE.

Comentarios

CMFCRibbonComboBox::EnableDropDownListResize

Especifica si el cuadro de lista puede cambiar el tamaño al desplegarse.

void EnableDropDownListResize(BOOL bEnable=FALSE);

Parámetros

bEnable
[in] TRUE para habilitar el cambio de tamaño; FALSE para deshabilitar el cambio de tamaño.

Comentarios

Cuando se habilita el cambio de tamaño, el cuadro de lista cambiará el tamaño para ajustarse a los elementos que muestra.

CMFCRibbonComboBox::FindItem

Devuelve el índice del primer elemento en el cuadro de lista que coincide con la cadena especificada.

int FindItem(LPCTSTR lpszText) const;

Parámetros

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

Valor devuelto

El índice de base cero del elemento; o -1 si el elemento no se encuentra.

Comentarios

CMFCRibbonComboBox::GetCount

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

INT_PTR GetCount() const;

Valor devuelto

El número de elementos en el cuadro de lista o 0 si el cuadro de lista no contiene ningún elemento.

Comentarios

CMFCRibbonComboBox::GetCurSel

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

int GetCurSel() const;

Valor devuelto

El índice de base cero del elemento seleccionado actualmente en el cuadro de lista; o -1 si no se selecciona ningún elemento.

CMFCRibbonComboBox::GetDropDownHeight

Obtiene la altura del cuadro de lista cuando se despliega el cuadro de lista.

int GetDropDownHeight();

Valor devuelto

La altura, en píxeles, del cuadro de lista.

Comentarios

CMFCRibbonComboBox::GetIntermediateSize

Devuelve el tamaño del cuadro combinado tal como se muestra en modo intermedio.

virtual CSize GetIntermediateSize(CDC* pDC);

Parámetros

pDC
[in] Un puntero a un contexto de dispositivo para el cuadro combinado.

Valor devuelto

El tamaño del cuadro combinado.

Comentarios

El tamaño devuelto se basa en el tamaño del cuadro combinado cuando muestra imágenes pequeñas.

CMFCRibbonComboBox::GetItem

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

LPCTSTR GetItem(int iIndex) const;

Parámetros

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

Valor devuelto

Un 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

CMFCRibbonComboBox::GetItemData

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

DWORD_PTR GetItemData(int iIndex) const;

Parámetros

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

Valor devuelto

Los datos asociados con el elemento; o 0 si el elemento no existe o si el parámetro del índice es -1 y no hay ningún elemento seleccionado en el cuadro de lista.

CMFCRibbonComboBox::HasEditBox

Indica si el control contiene un cuadro de edición.

BOOL HasEditBox() const;

Valor devuelto

TRUE si el control contiene un cuadro de edición; de lo contrario, FALSE.

Comentarios

CMFCRibbonComboBox::IsResizeDropDownList

Indica si se puede cambiar o no el tamaño del cuadro de lista.

BOOL IsResizeDropDownList() const;

Valor devuelto

TRUE si se puede cambiar el tamaño del cuadro de lista; de lo contrario, FALSE. CMFCRibbonComboBox::EnableDropDownListResize

Comentarios

Puede habilitar el cambio de tamaño del cuadro de lista mediante el método CMFCRibbonComboBox::EnableDropDownListResize.

CMFCRibbonComboBox::OnSelectItem

Lo llama el marco cuando el usuario selecciona un elemento en el cuadro de lista.

virtual void OnSelectItem(int nItem);

Parámetros

nItem
[in] El índice del elemento seleccionado.

Comentarios

Invalide este método si desea procesar una selección de entrada de usuario.

CMFCRibbonComboBox::RemoveAllItems

Elimina todos los elementos del cuadro de lista y borra el cuadro de edición.

void RemoveAllItems();

Comentarios

CMFCRibbonComboBox::SelectItem

Selecciona un elemento en el cuadro de lista.

BOOL SelectItem(int iIndex);
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.

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

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

Valor devuelto

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

Comentarios

CMFCRibbonComboBox::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.

Consulte también

Gráfico de jerarquías
Clases
CMFCRibbonEdit (clase)