CMFCRibbonButtonsGroup Class

Artículo
06/10/2015

La clase de CMFCRibbonButtonsGroup permite organizar un conjunto de botones de la cinta de opciones en un grupo. Todos los botones en el grupo están directamente adyacente a otro horizontalmente y agregados en un borde.

class CMFCRibbonButtonsGroup : public CMFCRibbonBaseElement

Members

Constructores públicos

Nombre	Descripción
CMFCRibbonButtonsGroup::CMFCRibbonButtonsGroup	Crea 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 el í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 en el grupo de la cinta (reemplaza CMFCRibbonBaseElement::GetImageSize.)
CMFCRibbonButtonsGroup::GetRegularSize	Devuelve el tamaño normal del elemento cinta (reemplaza CMFCRibbonBaseElement::GetRegularSize.)
CMFCRibbonButtonsGroup::HasImages	Notifica si el objeto de CMFCRibbonButtonsGroup contiene imágenes de la barra de herramientas.
CMFCRibbonButtonsGroup::OnDrawImage	Dibuja la imagen adecuada para un botón especificado, dependiendo de si el botón es normal, resaltado o deshabilitado.
CMFCRibbonButtonsGroup::RemoveAll	Quita todos los botones del objeto de CMFCRibbonButtonsGroup.
CMFCRibbonButtonsGroup::SetImages	Asigna imágenes al grupo.
CMFCRibbonButtonsGroup::SetParentCategory	Establece CMFCRibbonCategory primario del objeto de CMFCRibbonButtonsGroup y todos los botones dentro de (reemplaza CMFCRibbonBaseElement::SetParentCategory.)

Comentarios

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

Ejemplo

El ejemplo siguiente se muestra cómo utilizar varios métodos en la clase de CMFCRibbonButtonsGroup. El ejemplo muestra cómo construir un objeto de CMFCRibbonButtonsGroup, asignar imágenes al grupo de botones de la cinta de opciones, y agregar un botón al grupo de botones de la cinta de opciones. Este fragmento de código es parte de 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"));