Clase de CMFCRibbonButton

Artículo
02/19/2013

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