CMFCRibbonButton Class

Artículo
06/10/2015

La clase de CMFCRibbonButton implementa botones que puede colocar en elementos de barra de cinta como paneles, barras de herramientas de acceso rápido, y emergentes.

class CMFCRibbonButton : public CMFCRibbonBaseElement

Members

Constructores públicos

Name	Descripción
CMFCRibbonButton::CMFCRibbonButton	Construye un objeto de botón de la cinta de opciones.

Métodos públicos

Name	Descripción
CMFCRibbonButton::AddSubItem	Agrega un elemento de menú al menú emergente que está asociado al botón.
CMFCRibbonButton::CanBeStretched	(Reemplaza CMFCRibbonBaseElement::CanBeStretched.)
CMFCRibbonButton::CleanUpSizes	(Reemplaza CMFCRibbonBaseElement::CleanUpSizes.)
CMFCRibbonButton::ClosePopupMenu	(Reemplaza CMFCRibbonBaseElement::ClosePopupMenu.)
CMFCRibbonButton::DrawBottomText
CMFCRibbonButton::DrawImage	(Reemplaza CMFCRibbonBaseElement::DrawImage.)
CMFCRibbonButton::DrawRibbonText
CMFCRibbonButton::FindSubItemIndexByID	Devuelve el índice de un elemento de menú emergente que está asociado con el identificador especificado de comando
CMFCRibbonButton::GetCommandRect
CMFCRibbonButton::GetCompactSize	Devuelve el tamaño compacto de elemento cinta. (Reemplaza CMFCRibbonBaseElement::GetCompactSize.)
CMFCRibbonButton::GetIcon
CMFCRibbonButton::GetImageIndex	Devuelve el índice de la imagen que está asociado al botón.
CMFCRibbonButton::GetImageSize	Devuelve el tamaño de la imagen del elemento cinta. (Reemplaza CMFCRibbonBaseElement::GetImageSize.)
CMFCRibbonButton::GetIntermediateSize	Devuelve el tamaño del elemento cinta en su estado intermedia. (Reemplaza CMFCRibbonBaseElement::GetIntermediateSize.)
CMFCRibbonButton::GetMenu	Devuelve un identificador a un menú de Windows asignado al botón de la cinta de opciones.
CMFCRibbonButton::GetMenuRect
CMFCRibbonButton::GetRegularSize	Devuelve el tamaño normal del elemento cinta. (Reemplaza CMFCRibbonBaseElement::GetRegularSize.)
CMFCRibbonButton::GetSubItems
CMFCRibbonButton::GetTextRowHeight
CMFCRibbonButton::GetToolTipText	Devuelve el texto de información sobre herramientas del elemento cinta. (Reemplaza CMFCRibbonBaseElement::GetToolTipText.)
CMFCRibbonButton::HasCompactMode	Especifica si el elemento cinta tiene un modo compacto. (Reemplaza CMFCRibbonBaseElement::HasCompactMode.)
CMFCRibbonButton::HasIntermediateMode	Especifica si el elemento cinta tiene un modo intermedio. (Reemplaza CMFCRibbonBaseElement::HasIntermediateMode.)
CMFCRibbonButton::HasLargeMode	Determina si el elemento cinta tiene un modo grande. (Reemplaza CMFCRibbonBaseElement::HasLargeMode.)
CMFCRibbonButton::HasMenu	(Reemplaza CMFCRibbonBaseElement::HasMenu.)
CMFCRibbonButton::IsAlwaysDrawBorder
CMFCRibbonButton::IsAlwaysLargeImage	(Reemplaza CMFCRibbonBaseElement::IsAlwaysLargeImage.)
CMFCRibbonButton::IsApplicationButton
CMFCRibbonButton::IsCommandAreaHighlighted
CMFCRibbonButton::IsDefaultCommand	Determina si se ha habilitado el comando predeterminado para un botón de la cinta de opciones.
CMFCRibbonButton::IsDefaultPanelButton
CMFCRibbonButton::IsDrawTooltipImage
CMFCRibbonButton::IsLargeImage
CMFCRibbonButton::IsMenuAreaHighlighted
CMFCRibbonButton::IsMenuOnBottom
CMFCRibbonButton::IsPopupDefaultMenuLook
CMFCRibbonButton::IsRightAlignMenu	Determina si el menú está alineado a la derecha.
CMFCRibbonButton::IsSingleLineText
CMFCRibbonButton::OnCalcTextSize	(Reemplaza CMFCRibbonBaseElement::OnCalcTextSize.)
CMFCRibbonButton::OnDrawBorder
CMFCRibbonButton::OnDraw	Llamado por el marco para dibujar el elemento cinta. (Reemplaza CMFCRibbonBaseElement::OnDraw.)
CMFCRibbonButton::OnFillBackground
CMFCRibbonButton::RemoveAllSubItems	Quita todos los elementos de menú del menú emergente.
CMFCRibbonButton::RemoveSubItem	Quita un elemento de menú del menú emergente.
CMFCRibbonButton::SetACCData	(Reemplaza CMFCRibbonBaseElement::SetACCData.)
CMFCRibbonButton::SetAlwaysLargeImage	Especifica si el botón muestra una imagen grande o pequeña cuando el usuario contrae el botón.
CMFCRibbonButton::SetDefaultCommand	habilita el comando predeterminado para el botón de la cinta de opciones.
CMFCRibbonButton::SetDescription	Establece la descripción para el elemento cinta. (Reemplaza CMFCRibbonBaseElement::SetDescription.)
CMFCRibbonButton::SetImageIndex	Asigna un índice a la imagen del botón.
CMFCRibbonButton::SetMenu	Asigna un menú emergente al botón de la cinta de opciones.
CMFCRibbonButton::SetParentCategory	(Reemplaza CMFCRibbonBaseElement::SetParentCategory.)
CMFCRibbonButton::SetRightAlignMenu	Alinea el elemento emergente a la derecha del botón.
CMFCRibbonButton::SetText	Establece el texto para el elemento cinta. (Reemplaza CMFCRibbonBaseElement::SetText.)

Métodos protegidos

Name	Descripción
CMFCRibbonButton::OnClick	Llamado por el marco cuando el usuario hace clic en el botón.

Ejemplo

El ejemplo siguiente se muestra cómo utilizar los distintos métodos en la clase de CMFCRibbonButton . El ejemplo muestra cómo construir un objeto de clase de CMFCRibbonButton , asigne un menú emergente al botón de la cinta de opciones, establece la descripción del botón, quita un elemento de menú del menú emergente, y derecha alinear el menú emergente con el borde del botón.

   strTemp.LoadString(IDS_RIBBON_STYLE);
    // The first parameter is the command ID of the button. 
    // The third parameter is a zero-based index of the button's small image in the  
    // image list of the parent category. 
    // The fourth parameter is a zero-based index of the button's large image in the  
    // image list of the parent category.
    CMFCRibbonButton* pVisualStyleButton = new CMFCRibbonButton(1, strTemp, -1, -1);
    
    pVisualStyleButton->SetMenu(IDR_THEME_MENU, TRUE, TRUE);

    strTemp.LoadString(IDS_RIBBON_STYLE_TIP);
    pVisualStyleButton->SetToolTipText(strTemp);
    strTemp.LoadString(IDS_RIBBON_STYLE_DESC);
    pVisualStyleButton->SetDescription(strTemp);
    pVisualStyleButton->RemoveSubItem(0);
    pVisualStyleButton->SetRightAlignMenu(TRUE);

Comentarios

Para utilizar un botón de la cinta en una aplicación, cree el objeto de botón y agréguelo a la cinta de opciones adecuada panel.

CMFCRibbonPanel* pPanel = pCategory->AddPanel (
    _T("Clipboard"),                       // Panel name
    m_PanelIcons.ExtractIcon (0));  // Panel icon
// Create the first button ("Paste"):
CMFCRibbonButton* pPasteButton = 
    new CMFCRibbonButton (ID_EDIT_PASTE, _T("Paste"), -1, 0);
// The third parameter (-1) disables small images for button.
// This button is always displayed with a large image
// Associate a pop-up menu with the "Paste" button:
pPasteButton->SetMenu (IDR_CONTEXT_MENU);
// Add buttons to the panel. These buttons have only small images.
pPanel->Add (new CMFCRibbonButton (ID_EDIT_CUT, _T("Cut"), 1));
pPanel->Add (new CMFCRibbonButton (ID_EDIT_COPY, _T("Copy"), 2));
pPanel->Add (new CMFCRibbonButton (ID_EDIT_PAINT, _T("Paint"), 9));