CMFCRibbonButtonsGroup (clase)

La clase CMFCRibbonButtonsGroup permite organizar un conjunto de botones de la barra de herramientas en un grupo. Todos los botones del grupo son directamente adyacentes a otros horizontalmente y se incluyen en un borde.

Sintaxis

class CMFCRibbonButtonsGroup : public CMFCRibbonBaseElement

Miembros

Constructores públicos

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

Métodos públicos

Nombre	Descripción
CMFCRibbonButtonsGroup::AddButton	Agrega un botón a un grupo.
CMFCRibbonButtonsGroup::AddButtons	Agrega una lista de botones a un grupo.
CMFCRibbonButtonsGroup::GetButton	Devuelve un puntero al botón que se encuentra en un índice especificado.
CMFCRibbonButtonsGroup::GetCount	Devuelve el número de botones en el grupo.
CMFCRibbonButtonsGroup::GetImageSize	Devuelve el tamaño de imagen de las imágenes normales del grupo de la barra de herramientas (invalida CMFCRibbonBaseElement::GetImageSize).
CMFCRibbonButtonsGroup::GetRegularSize	Devuelve el tamaño normal del elemento de la barra de herramientas (invalida CMFCRibbonBaseElement::GetRegularSize).
CMFCRibbonButtonsGroup::HasImages	Notifica si el objeto CMFCRibbonButtonsGroup contiene imágenes de la barra de herramientas.
CMFCRibbonButtonsGroup::OnDrawImage	Dibuja la imagen adecuada para un botón especificado en función de si el botón es normal o está resaltado o deshabilitado.
CMFCRibbonButtonsGroup::RemoveAll	Quita todos los botones del objeto CMFCRibbonButtonsGroup.
CMFCRibbonButtonsGroup::SetImages	Asigna imágenes al grupo.
CMFCRibbonButtonsGroup::SetParentCategory	Establece la CMFCRibbonCategory primaria del objeto CMFCRibbonButtonsGroup y todos los botones que contiene (invalida CMFCRibbonBaseElement::SetParentCategory.)

Comentarios

El grupo deriva de CMFCBaseRibbonElement y se puede manipular como una entidad única. Puede colocar el grupo en cualquier panel o menú emergente.

Ejemplo

En el siguiente ejemplo se muestra cómo usar los distintos métodos en la clase CMFCRibbonButtonsGroup . En el ejemplo, se muestra cómo construir un objeto CMFCRibbonButtonsGroup, asignar imágenes al grupo de botones de la barra de herramientas y agregar un botón al grupo de botones de la barra de herramientas. Este fragmento de código forma parte del Ejemplo de cliente de dibujo.

CMFCRibbonButtonsGroup *pSBGroup = new CMFCRibbonButtonsGroup;

CMFCToolBarImages images;
images.SetImageSize(CSize(14, 14));

CMFCToolBarImages hotimages;
hotimages.SetImageSize(CSize(14, 14));

if (images.Load(IDB_STATUSBAR_1) && hotimages.Load(IDB_STATUSBAR_2))
{
   pSBGroup->SetImages(&images, &hotimages, NULL);
}

pSBGroup->AddButton(new CMFCRibbonButton(ID_FILE_PRINT_PREVIEW, _T(""), 0));
pSBGroup->AddButton(new CMFCRibbonButton(ID_FILE_SUMMARYINFO, _T(""), 1));

// CMFCRibbonStatusBar m_wndStatusBar
m_wndStatusBar.AddExtendedElement(pSBGroup, _T("View Shortcuts"));

Jerarquía de herencia

CObject

CMFCRibbonBaseElement

CMFCRibbonButtonsGroup

Requisitos

Encabezado: afxribbonbuttonsgroup.h

CMFCRibbonButtonsGroup::AddButton

Agrega un botón a un grupo.

void AddButton(CMFCRibbonBaseElement* pButton);

Parámetros

pButton
[in] Puntero a un botón que se va a agregar.

CMFCRibbonButtonsGroup::AddButtons

Agrega una lista de botones a un grupo.

void AddButtons(
    const CList<CMFCRibbonBaseElement*,CMFCRibbonBaseElement*>& lstButtons);

Parámetros

lstButtons
[in] Lista de punteros a los botones que desea agregar.

CMFCRibbonButtonsGroup::CMFCRibbonButtonsGroup

Construye un objeto CMFCRibbonButtonsGroup.

CMFCRibbonButtonsGroup();
CMFCRibbonButtonsGroup(CMFCRibbonBaseElement* pButton);

Parámetros

pButton
[in] Especifica un botón que se va a agregar al objeto CMFCRibbonButtonsGroup recién creado.

Valor devuelto

Comentarios

CMFCRibbonButtonsGroup::GetButton

Devuelve un puntero al botón que se encuentra en un índice especificado.

CMFCRibbonBaseElement* GetButton(int i) const;

Parámetros

i
[in] Índice de base cero de un botón que se va a devolver.

Valor devuelto

Puntero al botón que se encuentra en el índice especificado. NULL si el índice especificado está fuera del intervalo.

Comentarios

CMFCRibbonButtonsGroup::GetCount

Devuelve el número de botones en el grupo.

int GetCount() const;

Valor devuelto

Número de botones en el grupo.

CMFCRibbonButtonsGroup::GetImageSize

Recupera el tamaño de imagen de origen del miembro CMFCToolBarImages protegido m_Images.

const CSize GetImageSize() const;

Valor devuelto

Devuelve el tamaño de imagen de origen de las imágenes de la barra de herramientas, si hay alguna, o un CSize de cero, si no es así.

Comentarios

CMFCRibbonButtonsGroup::GetRegularSize

Recupera el tamaño máximo posible del elemento del grupo de la barra de herramientas.

virtual CSize GetRegularSize(CDC* pDC);

Parámetros

pDC
[in] Puntero al contexto de dispositivo del grupo de la barra de herramientas.

Valor devuelto

Comentarios

CMFCRibbonButtonsGroup::HasImages

Notifica si el objeto CMFCRibbonButtonsGroup contiene imágenes de la barra de herramientas.

BOOL HasImages() const;

Valor devuelto

Devuelve TRUE si el miembro CMFCToolBarImages protegido m_Images contiene imágenes o FALSE si no es así.

Comentarios

CMFCRibbonButtonsGroup::OnDrawImage

Dibuja la imagen adecuada para un botón especificado en función de si el botón es normal o está resaltado o deshabilitado.

virtual void OnDrawImage(
    CDC* pDC,
    CRect rectImage,
    CMFCRibbonBaseElement* pButton,
    int nImageIndex);

Parámetros

pDC
[in] Puntero al contexto de dispositivo del objeto CMFCRibbonButtonsGroup.

rectImage
[in] Rectángulo en el que se va a dibujar la imagen.

pButton
[in] Botón para el que se va a dibujar la imagen.

nImageIndex
[in] Índice de la imagen que se va a dibujar en el botón (en una de las tres matrices de imágenes para botones normales, resaltados o deshabilitados).

Comentarios

CMFCRibbonButtonsGroup::RemoveAll

Quita todos los botones del objeto CMFCRibbonButtonsGroup.

void RemoveAll();

Comentarios

CMFCRibbonButtonsGroup::SetImages

Asigna imágenes al grupo de botones de la barra de herramientas.

void SetImages(
    CMFCToolBarImages* pImages,
    CMFCToolBarImages* pHotImages,
    CMFCToolBarImages* pDisabledImages);

Parámetros

pImages
[in] Imágenes normales.

pHotImages
[in] Imágenes activas.

pDisabledImages
[in] Imágenes deshabilitadas.

Comentarios

Llame a SetImages antes de agregar botones a un grupo. El número de imágenes debe ser mayor o igual que el número de botones que se van a agregar al grupo.

Nota:

Las imágenes activas son las que se muestran cuando el usuario mantiene el puntero sobre el botón. Las imágenes deshabilitadas son las que se muestran cuando el botón está deshabilitado.

CMFCRibbonButtonsGroup::SetParentCategory

Establece la CMFCRibbonCategory primaria del objeto CMFCRibbonButtonsGroup y todos los botones que contiene.

virtual void SetParentCategory(CMFCRibbonCategory* pCategory);

Parámetros

pCategory
[in] Puntero a la categoría primaria que se va a establecer (los grupos con fichas en los controles de la barra de herramientas se denominan categorías).

Comentarios

Consulte también

Gráfico de jerarquías
Clases