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
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).