CReBar, classe
Barre de contrôles qui fournit des informations de disposition, de persistance et d'état pour les contrôles rebar.
Syntaxe
class CReBar : public CControlBar
Membres
Méthodes publiques
| Nom | Description |
|---|---|
| CReBar ::AddBar | Ajoute une bande à une barre de rebar. |
| CReBar ::Create | Crée le contrôle rebar et l’attache à l’objet CReBar . |
| CReBar ::GetReBarCtrl | Autorise l’accès direct au contrôle commun sous-jacent. |
Notes
Un objet rebar peut contenir plusieurs fenêtres enfants, généralement d'autres contrôles, notamment des zones d'édition, des barres d'outils et des zones de liste. Un objet rebar peut afficher les fenêtres enfants sur une image bitmap spécifiée. Votre application peut redimensionner automatiquement la barre de rebar, ou l’utilisateur peut redimensionner manuellement la barre de rebar en cliquant ou en faisant glisser sa barre de grippe.
Contrôle de la barre de rebar
Un objet de barre d’outils se comporte de la même façon qu’un objet de barre d’outils. Une barre de rebar utilise le mécanisme click-and-drag pour redimensionner ses bandes. Un contrôle de barre de rebar peut contenir une ou plusieurs bandes, chaque bande ayant n’importe quelle combinaison d’une barre de pince, d’une bitmap, d’une étiquette de texte et d’une fenêtre enfant. Toutefois, les bandes ne peuvent pas contenir plusieurs fenêtres enfants.
CReBar utilise la classe CReBarCtrl pour fournir son implémentation. Vous pouvez accéder au contrôle de barre de rebar via GetReBarCtrl pour tirer parti des options de personnalisation du contrôle. Pour plus d’informations sur les contrôles de barre d’outils, consultez CReBarCtrl. Pour plus d’informations sur l’utilisation de contrôles de barre de rébar, consultez Utilisation de CReBarCtrl.
Attention
Les objets de contrôle de barre de rebar et de rebar ne prennent pas en charge l’ancrage de la barre de contrôle MFC. Si CRebar::EnableDocking elle est appelée, votre application s’affirme.
Hiérarchie d'héritage
CReBar
Spécifications
En-tête : afxext.h
CReBar ::AddBar
Appelez cette fonction membre pour ajouter une bande à la barre de rebar.
BOOL AddBar(
CWnd* pBar,
LPCTSTR pszText = NULL,
CBitmap* pbmp = NULL,
DWORD dwStyle = RBBS_GRIPPERALWAYS | RBBS_FIXEDBMP);
BOOL AddBar(
CWnd* pBar,
COLORREF clrFore,
COLORREF clrBack,
LPCTSTR pszText = NULL,
DWORD dwStyle = RBBS_GRIPPERALWAYS);
Paramètres
pBar
Pointeur vers un CWnd objet qui est la fenêtre enfant à insérer dans la barre de rebar. L’objet référencé doit avoir un WS_CHILD.
lpszText
Pointeur vers une chaîne contenant le texte à afficher sur la barre de rebar. NULL par défaut. Le texte contenu dans lpszText ne fait pas partie de la fenêtre enfant ; il se trouve sur la barre de rebar elle-même.
pbmp
Pointeur vers un CBitmap objet à afficher sur l’arrière-plan de la barre de rebar. NULL par défaut.
dwStyle
DWORD contenant le style à appliquer à la barre de rebar. Pour obtenir la liste complète des styles de bande, consultez la description de la fStyle fonction dans la structure Win32 REBARBANDINFO .
clrFore
Valeur COLORREF qui représente la couleur de premier plan de la barre de rebar.
clrBack
Valeur COLORREF qui représente la couleur d’arrière-plan de la barre de rebar.
Valeur de retour
Valeur différente de zéro cas de réussite ; sinon, 0.
Exemple
// Define a CRebar in your class definition,
// such as: CReBar m_wndReBar;
m_wndReBar.Create(this);
m_wndDlgBar.Create(this, IDD_DIALOGBAR, CBRS_ALIGN_TOP,
IDD_DIALOGBAR);
m_wndReBar.AddBar(&m_wndDlgBar);
CReBar ::Create
Appelez cette fonction membre pour créer une barre d’accès.
virtual BOOL Create(
CWnd* pParentWnd,
DWORD dwCtrlStyle = RBS_BANDBORDERS,
DWORD dwStyle = WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS | WS_CLIPCHILDREN | CBRS_TOP,
UINT nID = AFX_IDW_REBAR);
Paramètres
pParentWnd
Pointeur vers l’objet CWnd dont la fenêtre Windows est le parent de la barre d’état. Normalement, votre fenêtre frame.
dwCtrlStyle
Style de contrôle de la barre de rebar. Par défaut, RBS_BANDBORDERS, qui affiche des lignes étroites pour séparer les bandes adjacentes dans le contrôle de barre de rebar. Consultez Styles de contrôle rebar dans le Kit de développement logiciel (SDK) Windows pour obtenir la liste des styles.
dwStyle
Styles de fenêtre de barre de rebar.
nID
ID de la fenêtre enfant de la barre de rebar.
Valeur de retour
Valeur différente de zéro cas de réussite ; sinon, 0.
Exemple
Consultez l’exemple de CReBar ::AddBar.
CReBar ::GetReBarCtrl
Cette fonction membre permet un accès direct au contrôle commun sous-jacent.
CReBarCtrl& GetReBarCtrl() const;
Valeur de retour
Référence à un objet CReBarCtrl .
Notes
Appelez cette fonction membre pour tirer parti des fonctionnalités du contrôle commun de la barre d’outils Windows lors de la personnalisation de votre barre de rebar. Lorsque vous appelez GetReBarCtrl, il retourne un objet de référence à l’objet afin de pouvoir utiliser l’un ou l’autre CReBarCtrl ensemble de fonctions membres.
Pour plus d’informations sur l’utilisation CReBarCtrl pour personnaliser votre barre de rebar, consultez Utilisation de CReBarCtrl.
Exemple
CReBarCtrl &refReBarCtrl = m_wndReBar.GetReBarCtrl();
UINT nBandCount = refReBarCtrl.GetBandCount();
CString msg;
msg.Format(_T("Band Count is: %u"), nBandCount);
AfxMessageBox(msg);