CMFCRibbonStatusBar, classe
La CMFCRibbonStatusBar classe implémente un contrôle de barre d’état qui peut afficher les éléments du ruban.
Syntaxe
class CMFCRibbonStatusBar : public CMFCRibbonBar
Membres
Méthodes publiques
| Nom | Description |
|---|---|
| CMFCRibbonStatusBar ::AddDynamicElement | Ajoute un élément dynamique à la barre d’état du ruban. |
| CMFCRibbonStatusBar ::AddElement | Ajoute un nouvel élément de ruban à la barre d’état du ruban. |
| CMFCRibbonStatusBar ::AddExtendedElement | Ajoute un élément de ruban à la zone étendue de la barre d’état du ruban. |
| CMFCRibbonStatusBar ::AddSeparator | Ajoute un séparateur à la barre d’état du ruban. |
| CMFCRibbonStatusBar ::Create | Crée une barre d’état du ruban. |
| CMFCRibbonStatusBar ::CreateEx | Crée une barre d’état du ruban avec un style étendu. |
| CMFCRibbonStatusBar ::FindByID | |
| CMFCRibbonStatusBar ::FindElement | Retourne un pointeur vers l’élément qui a l’ID de commande spécifié. |
| CMFCRibbonStatusBar ::GetCount | Retourne le nombre d’éléments situés dans la zone principale de la barre d’état du ruban. |
| CMFCRibbonStatusBar ::GetElement | Retourne un pointeur vers l’élément situé à un index spécifié. |
| CMFCRibbonStatusBar ::GetExCount | Retourne le nombre d’éléments situés dans la zone étendue de la barre d’état du ruban. |
| CMFCRibbonStatusBar ::GetExElement | Retourne un pointeur vers l'élément situé à l'index spécifié dans la zone étendue de la barre d'état du ruban. |
| CMFCRibbonStatusBar ::GetExtendedArea | |
| CMFCRibbonStatusBar ::GetSpace | |
| CMFCRibbonStatusBar ::IsBottomFrame | |
| CMFCRibbonStatusBar ::IsExtendedElement | |
| CMFCRibbonStatusBar ::IsInformationMode | Détermine si le mode d’informations est activé pour la barre d’état du ruban. |
| CMFCRibbonStatusBar ::RecalcLayout | (Remplacements CMFCRibbonBar ::RecalcLayout.) |
| CMFCRibbonStatusBar ::RemoveAll | Supprime tous les éléments de la barre d’état du ruban. |
| CMFCRibbonStatusBar ::RemoveElement | Supprime l’élément qui a un ID de commande spécifié dans la barre d’état du ruban. |
| CMFCRibbonStatusBar ::SetInformation | Active ou désactive le mode d’informations de la barre d’état du ruban. |
Méthodes protégées
| Nom | Description |
|---|---|
| CMFCRibbonStatusBar ::OnDrawInformation | Affiche la chaîne d’informations qui apparaît dans la barre d’état du ruban lorsque le mode d’information est activé. |
Notes
Les utilisateurs peuvent modifier la visibilité des éléments du ruban sur une barre d’état du ruban à l’aide du menu contextuel intégré de la barre d’état du ruban. Vous pouvez ajouter ou supprimer des éléments dynamiquement.
Une barre d’état du ruban comporte deux zones : une zone principale et une zone étendue. La zone étendue s’affiche sur le côté droit de la barre d’état du ruban et apparaît dans une couleur différente de celle de la zone principale.
En règle générale, la zone principale de la barre d’état affiche les notifications d’état et la zone étendue affiche les contrôles d’affichage. La zone étendue reste visible tant que possible lorsque l’utilisateur redimensionne la barre d’état du ruban.
Exemple
L’exemple suivant montre comment utiliser différentes méthodes de la classe CMFCRibbonStatusBar . L’exemple montre comment ajouter un nouvel élément de ruban à la barre d’état du ruban, ajouter un élément de ruban à la zone étendue de la barre d’état du ruban, ajouter un séparateur et activer le mode normal pour la barre d’état du ruban.
// CMFCRibbonStatusBar m_wndStatusBar
m_wndStatusBar.AddElement(rsbp, strTitlePane1);
m_wndStatusBar.AddExtendedElement(new CMFCRibbonStatusBarPane(ID_STATUSBAR_PANE2, strTitlePane2, TRUE),
strTitlePane2);
m_wndStatusBar.AddSeparator();
m_wndStatusBar.SetInformation(NULL);
Hiérarchie d'héritage
Spécifications
En-tête : afxribbonstatusbar.h
CMFCRibbonStatusBar ::AddDynamicElement
Ajoute un élément dynamique à la barre d’état du ruban.
void AddDynamicElement(CMFCRibbonBaseElement* pElement);
Paramètres
pElement
[in] Pointeur vers un élément dynamique.
Notes
Contrairement aux éléments réguliers, les éléments dynamiques ne sont pas personnalisables et le menu personnaliser de la barre d’état ne les affiche pas.
CMFCRibbonStatusBar ::AddElement
Ajoute un nouvel élément de ruban à la barre d’état du ruban.
void AddElement(
CMFCRibbonBaseElement* pElement,
LPCTSTR lpszLabel,
BOOL bIsVisible=TRUE);
Paramètres
pElement
[in] Pointeur vers l’élément ajouté.
lpszLabel
[in] Étiquette de texte de l’élément.
bIsVisible
[in] TRUE si vous souhaitez ajouter l’élément comme visible, FALSE si vous souhaitez ajouter l’élément comme masqué.
CMFCRibbonStatusBar ::AddExtendedElement
Ajoute un élément de ruban à la zone étendue de la barre d’état du ruban.
void AddExtendedElement(
CMFCRibbonBaseElement* pElement,
LPCTSTR lpszLabel,
BOOL bIsVisible=TRUE);
Paramètres
pElement
[in] Pointeur vers l’élément ajouté.
lpszLabel
[in] Étiquette de texte de l’élément.
bIsVisible
[in] TRUE si vous souhaitez ajouter l’élément comme visible, FALSE si vous souhaitez ajouter l’élément comme masqué.
Notes
La zone étendue se trouve sur le côté droit du contrôle de barre d'état.
CMFCRibbonStatusBar ::AddSeparator
Ajoute un séparateur à la barre d’état du ruban.
void AddSeparator();
Notes
L’infrastructure ajoute un séparateur après la méthode CMFCRibbonStatusBar ::AddElement. insère le dernier élément.
CMFCRibbonStatusBar ::Create
Crée une barre d’état du ruban.
BOOL Create(
CWnd* pParentWnd,
DWORD dwStyle=WS_CHILD|WS_VISIBLE|CBRS_BOTTOM,
UINT nID=AFX_IDW_STATUS_BAR);
Paramètres
pParentWnd
[in] Pointeur vers la fenêtre parente.
dwStyle
[in] Combinaison LOGIQUE OU des styles de contrôle.
nID
[in] ID de contrôle de la barre d’état.
Valeur de retour
TRUE si la barre d’état est créée avec succès, sinon FALSE.
CMFCRibbonStatusBar ::CreateEx
Crée une barre d’état du ruban qui a un style étendu.
BOOL CreateEx(
CWnd* pParentWnd,
DWORD dwCtrlStyle=0,
DWORD dwStyle=WS_CHILD|WS_VISIBLE|CBRS_BOTTOM,
UINT nID=AFX_IDW_STATUS_BAR);
Paramètres
pParentWnd
Pointeur vers la fenêtre parente.
dwCtrlStyle
Combinaison OR logique de styles supplémentaires pour la création de l’objet de barre d’état.
dwStyle
Style de contrôle de la barre d’état.
nID
ID de contrôle de la barre d’état.
Valeur de retour
TRUE si la barre d’état est créée avec succès, sinon FALSE.
CMFCRibbonStatusBar ::FindByID
Pour plus d’informations, consultez le code source situé dans le dossier VC\atlmfc\src\mfc de votre installation de Visual Studio.
CMFCRibbonBaseElement* FindByID(UINT uiCmdID, BOOL = TRUE);
Paramètres
[in] uiCmdID
[in] BOOL
Valeur de retour
Notes
CMFCRibbonStatusBar ::FindElement
Retourne un pointeur vers l’élément qui a l’ID de commande spécifié.
CMFCRibbonBaseElement* FindElement(UINT uiID);
Paramètres
uiID
[in] ID de l’élément.
Valeur de retour
Pointeur vers l’élément qui a l’ID de commande spécifié. NULL s’il n’existe aucun élément de ce type.
CMFCRibbonStatusBar ::GetCount
Retourne le nombre d’éléments situés dans la zone principale de la barre d’état du ruban.
int GetCount() const;
Valeur de retour
Nombre d’éléments situés dans la zone principale de la barre d’état du ruban.
CMFCRibbonStatusBar ::GetElement
Retourne un pointeur vers l’élément situé à un index spécifié.
CMFCRibbonBaseElement* GetElement(int nIndex);
Paramètres
nIndex
[in] Spécifie un index de base zéro d’un élément situé dans la zone principale du contrôle de barre d’état.
Valeur de retour
Pointeur vers l’élément situé à l’index spécifié. NULL si l’index est négatif ou dépasse le nombre d’éléments dans la barre d’état.
Notes
CMFCRibbonStatusBar ::GetExCount
Retourne le nombre d’éléments situés dans la zone étendue de la barre d’état du ruban.
int GetExCount() const;
Valeur de retour
Nombre d’éléments situés dans la zone étendue de la barre d’état du ruban.
CMFCRibbonStatusBar ::GetExElement
Retourne un pointeur vers l'élément situé à l'index spécifié dans la zone étendue de la barre d'état du ruban. La zone étendue se trouve sur le côté droit du contrôle de barre d'état.
CMFCRibbonBaseElement* GetExElement(int nIndex);
Paramètres
nIndex
[in] Spécifie l’index de base zéro d’un élément situé dans la zone étendue du contrôle de barre d’état.
Valeur de retour
Pointeur vers l'élément situé à l'index spécifié dans la zone étendue de la barre d'état du ruban. NULL si nIndex est négatif ou dépasse le nombre d’éléments dans la zone étendue de la barre d’état du ruban.
Notes
CMFCRibbonStatusBar ::GetExtendedArea
Pour plus d’informations, consultez le code source situé dans le dossier VC\atlmfc\src\mfc de votre installation de Visual Studio.
virtual BOOL GetExtendedArea(CRect& rect) const;
Paramètres
[in] rect
Valeur de retour
Notes
CMFCRibbonStatusBar ::GetSpace
Pour plus d’informations, consultez le code source situé dans le dossier VC\atlmfc\src\mfc de votre installation de Visual Studio.
int GetSpace() const;
Valeur de retour
Notes
CMFCRibbonStatusBar ::IsBottomFrame
Pour plus d’informations, consultez le code source situé dans le dossier VC\atlmfc\src\mfc de votre installation de Visual Studio.
BOOL IsBottomFrame() const;
Valeur de retour
Notes
CMFCRibbonStatusBar ::IsExtendedElement
Pour plus d’informations, consultez le code source situé dans le dossier VC\atlmfc\src\mfc de votre installation de Visual Studio.
BOOL IsExtendedElement(CMFCRibbonBaseElement* pElement) const;
Paramètres
[in] pElement
Valeur de retour
Notes
CMFCRibbonStatusBar ::IsInformationMode
Détermine si le mode d’informations est activé pour la barre d’état du ruban.
BOOL IsInformationMode() const;
Valeur de retour
TRUE si la barre d’état peut fonctionner en mode d’informations ; sinon FALSE.
Notes
En mode Informations, la barre d’état masque tous les volets réguliers et affiche une chaîne de message.
CMFCRibbonStatusBar ::OnDrawInformation
Affiche la chaîne qui apparaît dans la barre d’état du ruban lorsque le mode d’informations est activé.
virtual void OnDrawInformation(
CDC* pDC,
CString& strInfo,
CRect rectInfo);
Paramètres
pDC
[in] Pointeur vers un contexte d’appareil.
strInfo
[in] Chaîne d’informations.
rectInfo
[in] Rectangle englobant.
Notes
Remplacez cette méthode dans une classe dérivée si vous souhaitez personnaliser l’apparence de la chaîne d’informations dans la barre d’état. Utilisez la méthode CMFCRibbonStatusBar ::SetInformation pour placer la barre d’état en mode d’informations. Dans ce mode, la barre d’état masque tous les volets et affiche la chaîne d’informations spécifiée par strInfo.
CMFCRibbonStatusBar ::RecalcLayout
Pour plus d’informations, consultez le code source situé dans le dossier VC\atlmfc\src\mfc de votre installation de Visual Studio.
virtual void RecalcLayout();
Notes
CMFCRibbonStatusBar ::RemoveAll
Supprime tous les éléments de la barre d’état du ruban.
void RemoveAll();
CMFCRibbonStatusBar ::RemoveElement
Supprime l’élément qui a un ID de commande spécifié dans la barre d’état du ruban.
BOOL RemoveElement(UINT uiID);
Paramètres
uiID
[in] ID de l’élément à supprimer de la barre d’état.
Valeur de retour
TRUE si un élément avec l’UIID spécifié est supprimé. FALSE dans le cas contraire.
CMFCRibbonStatusBar ::SetInformation
Active ou désactive le mode d’informations de la barre d’état du ruban.
void SetInformation(LPCTSTR lpszInfo);
Paramètres
lpszInfo
[in] Chaîne d’informations.
Notes
Utilisez cette méthode pour placer la barre d’état en mode d’informations. Dans ce mode, la barre d’état masque tous les volets et affiche la chaîne d’informations spécifiée par lpszInfo.
Lorsque lpszInfo a la valeur NULL, la barre d’état revient au mode normal.
Voir aussi
Graphique hiérarchique
Classes
CMFCRibbonBar, classe
CMFCRibbonBaseElement, classe
CMFCRibbonBar, classe