CMFCRibbonSeparator, classe
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
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é.