Partager via

CMFCRibbonSeparator, classe

  • Article

Implémente le séparateur de ruban.

Syntaxe

class CMFCRibbonSeparator : public CMFCRibbonBaseElement

Membres

Constructeurs publics

Nom Description
CMFCRibbonSeparator ::CMFCRibbonSeparator Construit un objet CMFCRibbonSeparator.

Méthodes publiques

Nom Description
CMFCRibbonSeparator ::AddToListBox Ajoute un séparateur à la liste Commandes dans la boîte de dialogue Personnaliser . (Remplacements CMFCRibbonBaseElement ::AddToListBox.)
CMFCRibbonSeparator::CreateObject Utilisé par l'infrastructure pour créer une instance dynamique de ce type de classe.
CMFCRibbonSeparator::GetThisClass Utilisé par l’infrastructure pour obtenir un pointeur vers l’objet CRuntimeClass associé à ce type de classe.

Méthodes protégées

Nom Description
CMFCRibbonSeparator ::CopyFrom Méthode de copie qui définit les variables membres d’un séparateur d’un autre objet.
CMFCRibbonSeparator ::GetRegularSize Retourne la taille d’un séparateur.
CMFCRibbonSeparator ::IsSeparator Indique s’il s’agit d’un séparateur.
CMFCRibbonSeparator ::IsTabstop Indique s’il s’agit d’un taquet de tabulation.
CMFCRibbonSeparator ::OnDraw Appelé par le système pour dessiner le séparateur sur le ruban ou la barre d’outils Accès rapide.
CMFCRibbonSeparator ::OnDrawOnList Appelé par le système pour dessiner le séparateur dans la liste Commandes .

Notes

Un séparateur de ruban est une ligne verticale ou horizontale qui sépare logiquement les éléments du ruban. Un séparateur peut être dessiné sur le contrôle du ruban, le menu de l’application principale, la barre d’état du ruban et la barre d’outils Accès rapide.

Pour utiliser un séparateur dans votre application, construisez le nouvel objet et ajoutez-le au menu principal de l’application, comme indiqué ici :

CMFCRibbonMainPanel* pMainPanel = m_wndRibbonBar.AddMainCategory(_T("Main Menu"),
    IDB_FILESMALL,
    IDB_FILELARGE);

...
pMainPanel->Add(new CMFCRibbonSeparator(TRUE));

Appelez CMFCRibbonPanel ::AddSeparator pour ajouter des séparateurs aux panneaux du ruban. Les séparateurs sont alloués et ajoutés en interne par la AddSeparator méthode.

Hiérarchie d'héritage

CObject

CMFCRibbonBaseElement

CMFCRibbonSeparator

Spécifications

En-tête : afxbaseribbonelement.h

CMFCRibbonSeparator ::AddToListBox

Ajoute un séparateur à la liste Commandes dans la boîte de dialogue Personnaliser .

virtual int AddToListBox(
    CMFCRibbonCommandsListBox* pWndListBox,
    BOOL bDeep);

Paramètres

pWndListBox
[in] Pointeur vers la liste commandes où le séparateur est ajouté.

bDeep
[in] Ignoré.

Valeur de retour

Index de base zéro à la chaîne dans la zone de liste spécifiée par pWndListBox.

CMFCRibbonSeparator ::CMFCRibbonSeparator

Construit un objet CMFCRibbonSeparator.

CMFCRibbonSeparator(BOOL bIsHoriz = FALSE);

Paramètres

bIsHoriz
[in] Si la valeur est TRUE, le séparateur est horizontal ; si la valeur est FALSE, le séparateur est vertical.

Notes

Les séparateurs horizontaux sont utilisés dans les menus d’application. Les séparateurs verticaux sont utilisés dans les barres d’outils.

Exemple

L’exemple suivant montre comment construire un objet de la CMFCRibbonSeparator classe.

// CMFCRibbonMainPanel* pMainPanel
pMainPanel->Add(new CMFCRibbonSeparator(TRUE));

CMFCRibbonSeparator ::CopyFrom

Méthode de copie qui définit les variables membres d’un séparateur d’un autre objet.

virtual void CopyFrom(const CMFCRibbonBaseElement& src);

Paramètres

Src
[in] Élément du ruban source à partir duquel copier.

CMFCRibbonSeparator ::GetRegularSize

Retourne la taille d’un séparateur.

virtual CSize GetRegularSize(CDC* pDC);

Paramètres

pDC
[in] Pointeur vers un contenu d’appareil.

Valeur de retour

Taille du séparateur sur le contexte d’appareil donné.

CMFCRibbonSeparator ::IsSeparator

Indique s’il s’agit d’un séparateur.

virtual BOOL IsSeparator() const;

Valeur de retour

Toujours TRUE pour cette classe.

CMFCRibbonSeparator ::IsTabstop

Indique s’il s’agit d’un taquet de tabulation.

virtual BOOL IsTabStop() const;

Valeur de retour

Toujours FALSE pour cette classe.

Notes

Un séparateur de ruban n’est pas un taquet de tabulation.

CMFCRibbonSeparator ::OnDraw

Appelé par le système pour dessiner le séparateur sur le ruban ou la barre d’outils Accès rapide.

virtual void OnDraw(CDC* pDC);

Paramètres

pDC
[in] Pointeur vers un contexte d’appareil.

CMFCRibbonSeparator ::OnDrawOnList

Appelé par le système pour dessiner le séparateur dans la liste Commandes .

virtual void OnDrawOnList(
    CDC* pDC,
    CString strText,
    int nTextOffset,
    CRect rect,
    BOOL bIsSelected,
    BOOL bHighlighted);

Paramètres

pDC
[in] Pointeur vers un contexte d’appareil.

strText
[in] Texte affiché dans la liste.

nTextOffset
[in] Espacement entre le texte et le côté gauche du rectangle englobant.

rect
[in] Spécifie le rectangle englobant.

bIsSelected
[in] Ignoré.

bHighlighted
[in] Ignoré.

Voir aussi

Graphique hiérarchique
Classes