Share via


CMFCRibbonMainPanel, classe

Implémente un panneau de ruban qui s’affiche lorsque vous cliquez sur CMFCRibbonApplicationButton.

Syntaxe

class CMFCRibbonMainPanel : public CMFCRibbonPanel

Membres

Constructeurs publics

Nom Description
CMFCRibbonMainPanel::CMFCRibbonMainPanel Constructeur par défaut.
CMFCRibbonMainPanel::~CMFCRibbonMainPanel Destructeur.

Méthodes publiques

Nom Description
CMFCRibbonMainPanel ::Add Ajoute un élément de ruban dans le volet gauche du volet bouton de l’application. (Remplacements CMFCRibbonPanel ::Add.)
CMFCRibbonMainPanel ::AddRecentFilesList Ajoute une chaîne de texte au menu de liste de fichiers récents.
CMFCRibbonMainPanel ::AddToBottom Ajoute un élément de ruban dans le volet inférieur du panneau d’application du ruban.
CMFCRibbonMainPanel ::AddToRight Ajoute un élément de ruban au volet droit du panneau du bouton d’application.
CMFCRibbonMainPanel::CreateObject Utilisé par l'infrastructure pour créer une instance dynamique de ce type de classe.
CMFCRibbonMainPanel ::GetCommandsFrame Retourne un rectangle qui représente la zone du panneau principal du ruban.
CMFCRibbonMainPanel::GetThisClass Utilisé par l’infrastructure pour obtenir un pointeur vers l’objet CRuntimeClass associé à ce type de classe.

Notes

L’infrastructure affiche le CMFCRibbonMainPanel moment où vous ouvrez le panneau d’application. Il contient trois volets :

  • Le volet gauche contient des commandes associées à des fichiers, telles que Open, Save, Print et Close. Pour ajouter une commande à ce volet, appelez CMFCRibbonMainPanel ::Add.

  • Le volet droit contient des options qui modifient la commande que vous cliquez dans le volet gauche. Par exemple, si vous cliquez sur Enregistrer sous dans le volet gauche, le volet droit peut afficher les types de fichiers disponibles. Pour ajouter un élément à ce volet, appelez CMFCRibbonMainPanel ::AddToRight.

  • Le volet inférieur contient des boutons qui vous permettent de modifier les paramètres de l’application et de quitter le programme. Pour ajouter un élément à ce volet, appelez CMFCRibbonMainPanel ::AddToBottom.

Hiérarchie d'héritage

CObject

CMFCRibbonPanel

CMFCRibbonMainPanel

Spécifications

En-tête : afxRibbonMainPanel.h

CMFCRibbonMainPanel ::Add

Ajoute un élément de ruban dans le volet gauche du volet bouton de l’application.

virtual void Add(CMFCRibbonBaseElement* pElem);

Paramètres

pElem
[in, out] Pointeur vers l’élément du ruban à ajouter au panneau principal.

Notes

Ajoute un élément de ruban au panneau. Les éléments ajoutés à l’aide de cette méthode se trouvent dans la colonne gauche du panneau principal.

CMFCRibbonMainPanel ::AddRecentFilesList

Ajoute une chaîne de texte au menu de liste de fichiers récents.

void AddRecentFilesList(
    LPCTSTR lpszLabel,
    int nWidth = 300);

Paramètres

lpszLabel
Spécifie la chaîne à ajouter à la liste des fichiers récents.

nWidth
Spécifie la largeur, en pixels, du panneau de liste des fichiers récents.

Notes

CMFCRibbonMainPanel ::AddToBottom

Ajoute un élément de ruban dans le volet inférieur du panneau d’application du ruban.

void AddToBottom(CMFCRibbonMainPanelButton* pElem);

Paramètres

pElem
[in, out] Pointeur vers l’élément du ruban à ajouter au bas du panneau principal.

Notes

CMFCRibbonMainPanel ::AddToRight

Ajoute un élément de ruban au volet droit du panneau du bouton d’application.

void AddToRight(
    CMFCRibbonBaseElement* pElem,
    int nWidth = 300);

Paramètres

pElem
Pointeur vers un élément de ruban à ajouter à droite du panneau principal.

nWidth
Spécifie la largeur, en pixels, du panneau droit.

Notes

Utilisez cette fonction pour ajouter un élément de ruban au panneau droit. Le panneau droit affiche généralement la liste des fichiers récents, mais vous pouvez ajouter n’importe quel autre élément du ruban ici.

CMFCRibbonMainPanel ::GetCommandsFrame

Retourne un rectangle qui représente la zone du panneau principal du ruban.

CRect GetCommandsFrame() const;

Valeur de retour

Rectangle qui représente la zone du panneau principal du ruban.

Voir aussi

Graphique hiérarchique
Classes
CMFCRibbonPanel, classe