Classe de CMFCRibbonButton

Article
03/04/2013

La classe d' CMFCRibbonButton implémente les boutons que vous pouvez positionner des éléments de barre du ruban tels que les panneaux, des Barres d'outils Accès rapides, et des menus contextuels.

class CMFCRibbonButton : public CMFCRibbonBaseElement

Membres

Constructeurs publics

Nom	Description
CMFCRibbonButton::CMFCRibbonButton	Crée un objet de ruban.

Méthodes publiques

Nom	Description
CMFCRibbonButton::AddSubItem	Ajoute un élément de menu au menu contextuel associé au bouton.
CMFCRibbonButton::CanBeStretched	(Substitutions CMFCRibbonBaseElement::CanBeStretched.)
CMFCRibbonButton::CleanUpSizes	(Substitutions CMFCRibbonBaseElement::CleanUpSizes.)
CMFCRibbonButton::ClosePopupMenu	(Substitutions CMFCRibbonBaseElement::ClosePopupMenu.)
CMFCRibbonButton::DrawBottomText
CMFCRibbonButton::DrawImage	(Substitutions CMFCRibbonBaseElement::DrawImage.)
CMFCRibbonButton::DrawRibbonText
CMFCRibbonButton::FindSubItemIndexByID	Retourne l'index d'un élément de menu contextuel associé à l'ID spécifiée de commande
CMFCRibbonButton::GetCommandRect
CMFCRibbonButton::GetCompactSize	Retourne la taille compacte de l'élément ruban.(Substitutions CMFCRibbonBaseElement::GetCompactSize.)
CMFCRibbonButton::GetIcon
CMFCRibbonButton::GetImageIndex	Retourne l'index de l'icône associée à le bouton.
CMFCRibbonButton::GetImageSize	Retourne la taille de l'image de l'élément ruban.(Substitutions CMFCRibbonBaseElement::GetImageSize.)
CMFCRibbonButton::GetIntermediateSize	Retourne la taille de l'élément ruban dans son état intermédiaire.(Substitutions CMFCRibbonBaseElement::GetIntermediateSize.)
CMFCRibbonButton::GetMenu	Retourne un handle vers un menu de windows assigné au ruban.
CMFCRibbonButton::GetMenuRect
CMFCRibbonButton::GetRegularSize	Retourne la taille normale de l'élément ruban.(Substitutions CMFCRibbonBaseElement::GetRegularSize.)
CMFCRibbonButton::GetSubItems
CMFCRibbonButton::GetTextRowHeight
CMFCRibbonButton::GetToolTipText	Texte d'info-bulle de la valeur de l'élément ruban.(Substitutions CMFCRibbonBaseElement::GetToolTipText.)
CMFCRibbonButton::HasCompactMode	Spécifie si l'élément ruban a un état compact.(Substitutions CMFCRibbonBaseElement::HasCompactMode.)
CMFCRibbonButton::HasIntermediateMode	Spécifie si l'élément ruban a un état intermédiaire.(Substitutions CMFCRibbonBaseElement::HasIntermediateMode.)
CMFCRibbonButton::HasLargeMode	Détermine si l'élément ruban possède un grand mode.(Substitutions CMFCRibbonBaseElement::HasLargeMode.)
CMFCRibbonButton::HasMenu	(Substitutions CMFCRibbonBaseElement::HasMenu.)
CMFCRibbonButton::IsAlwaysDrawBorder
CMFCRibbonButton::IsAlwaysLargeImage	(Substitutions CMFCRibbonBaseElement::IsAlwaysLargeImage.)
CMFCRibbonButton::IsApplicationButton
CMFCRibbonButton::IsCommandAreaHighlighted
CMFCRibbonButton::IsDefaultCommand	Détermine si vous avez activé la commande par défaut pour un bouton de ruban.
CMFCRibbonButton::IsDefaultPanelButton
CMFCRibbonButton::IsDrawTooltipImage
CMFCRibbonButton::IsLargeImage
CMFCRibbonButton::IsMenuAreaHighlighted
CMFCRibbonButton::IsMenuOnBottom
CMFCRibbonButton::IsPopupDefaultMenuLook
CMFCRibbonButton::IsRightAlignMenu	Détermine si le menu est aligné à droite.
CMFCRibbonButton::IsSingleLineText
CMFCRibbonButton::OnCalcTextSize	(Substitutions CMFCRibbonBaseElement::OnCalcTextSize.)
CMFCRibbonButton::OnDrawBorder
CMFCRibbonButton::OnDraw	Appelé par l'infrastructure pour dessiner l'élément ruban.(Substitutions CMFCRibbonBaseElement::OnDraw.)
CMFCRibbonButton::OnFillBackground
CMFCRibbonButton::RemoveAllSubItems	Supprime tous les éléments du menu contextuel.
CMFCRibbonButton::RemoveSubItem	Supprime un élément de menu dans le menu contextuel.
CMFCRibbonButton::SetACCData	(Substitutions CMFCRibbonBaseElement::SetACCData.)
CMFCRibbonButton::SetAlwaysLargeImage	Spécifie si le bouton affiche une grande ou petite image lorsque l'utilisateur réduite le bouton.
CMFCRibbonButton::SetDefaultCommand	Active la commande par défaut du ruban.
CMFCRibbonButton::SetDescription	Définit la description de l'élément ruban.(Substitutions CMFCRibbonBaseElement::SetDescription.)
CMFCRibbonButton::SetImageIndex	Assigne un index de l'image du bouton.
CMFCRibbonButton::SetMenu	Assigne un menu contextuel au ruban.
CMFCRibbonButton::SetParentCategory	(Substitutions CMFCRibbonBaseElement::SetParentCategory.)
CMFCRibbonButton::SetRightAlignMenu	Aligne le menu contextuel à droite du bouton.
CMFCRibbonButton::SetText	Définit le texte de l'élément ruban.(Substitutions CMFCRibbonBaseElement::SetText.)

Méthodes protégées

Nom	Description
CMFCRibbonButton::OnClick	Appelé par l'infrastructure lorsque l'utilisateur clique sur le bouton.

Exemple

L'exemple suivant montre comment utiliser les différentes méthodes dans la classe d' CMFCRibbonButton .L'exemple montre comment construire un objet avec de la classe d' CMFCRibbonButton , assigner un menu contextuel au ruban, définir la description du bouton, supprimer un élément de menu dans le menu contextuel, et la droite alignent le menu contextuel au bord de le bouton.

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

Notes

Pour utiliser un ruban dans une application, construire l'objet de bouton et l'ajouter au ruban approprié panneau.

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