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

CObject

CCmdTarget

CWnd

CControlBar

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);

Voir aussi

MFC, exemple MFCIE
CControlBar Class
Graphique hiérarchique