CMFCReBar, classe

Un CMFCReBar objet est une barre de contrôle qui fournit des informations de disposition, de persistance et d’état pour les contrôles de barre de contrôle. Pour plus d’informations, consultez le code source situé dans le dossier VC\atlmfc\src\mfc de votre installation de Visual Studio.

Syntaxe

class CMFCReBar : public CPane

Membres

Méthodes publiques

Notes

Un CMFCReBar objet peut contenir une variété de fenêtres enfants. Cela inclut les zones d’édition, les barres d’outils et les zones de liste. Vous pouvez redimensionner la barre de rebar par programmation, ou l’utilisateur peut redimensionner manuellement la barre de rebar en faisant glisser sa barre de pince. Vous pouvez également définir l’arrière-plan d’un objet rebar sur une bitmap de votre choix.

Un objet de barre d’outils se comporte de la même façon qu’un objet de barre d’outils. Un contrôle de barre de rebar peut contenir une ou plusieurs bandes, et chaque bande peut contenir une barre de grippe, une bitmap, une étiquette de texte et une fenêtre enfant.

Exemple

L’exemple suivant montre comment utiliser différentes méthodes de la classe CMFCReBar . L’exemple montre comment créer un contrôle de barre de rebar et y ajouter une bande. La bande fonctionne comme une barre d’outils interne. Cet extrait de code fait partie de l’exemple rebar Test.

CMFCReBar m_wndReBar;

// Each rebar pane will ocupy its own row:
DWORD dwStyle = RBBS_GRIPPERALWAYS | RBBS_FIXEDBMP | RBBS_BREAK;
// CMFCMenuBar m_wndMenuBar
// CMFCToolBar m_wndToolBar
if (!m_wndReBar.Create(this) ||
    !m_wndReBar.AddBar(&m_wndMenuBar) ||
    !m_wndReBar.AddBar(&m_wndToolBar, NULL, NULL, dwStyle))
{
   TRACE0("Failed to create rebar\n");
   return -1; // fail to create
}

Hiérarchie d'héritage

CObject
└ CCmdTarget
 └ CWnd
  └ CBasePane
   └ CPane
    └ CMFCReBar

Spécifications

En-tête : afxRebar.h

CMFCReBar ::AddBar

Ajoute une bande à une 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
[in, out] Pointeur vers la fenêtre enfant à insérer dans la barre de rebar. L’objet référencé doit avoir le style de fenêtre WS_CHILD .

pszText
[in] Spécifie le texte à afficher dans la barre de rebar. Le texte ne fait pas partie de la fenêtre enfant. Au lieu de cela, elle est affichée sur la barre de rebar elle-même.

pbmp
[in, out] Spécifie l’image bitmap à afficher sur l’arrière-plan de la barre de rebar.

dwStyle
[in] Contient le style à appliquer à la bande. Pour obtenir la liste complète des styles de bande, consultez la description de fStyle la structure REBARBANDINFO dans la documentation du Kit de développement logiciel (SDK) Windows.

clrFore
[in] Représente la couleur de premier plan de la barre de rebar.

clrBack
[in] Représente la couleur d’arrière-plan de la barre de rebar.

Valeur de retour

TRUE si la bande a été correctement ajoutée à la barre de rebar ; sinon, FALSE.

CMFCReBar ::Create

Crée le contrôle rebar et l’attache à l’objet CMFCReBar .

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
[in, out] Pointeur vers la fenêtre parente de ce contrôle de barre de rebar.

dwCtrlStyle
[in] Spécifie le style du contrôle de barre de rebar. La valeur de style par défaut est RBS_BANDBORDERS, qui affiche des lignes étroites pour séparer les bandes adjacentes sur le contrôle de barre de rebar. Pour obtenir la liste des styles valides, consultez La documentation relative aux styles de contrôle de la barre de rebar dans la documentation du Kit de développement logiciel (SDK) Windows.

dwStyle
[in] Style de fenêtre du contrôle rebar. Pour obtenir la liste des styles valides, consultez Styles de fenêtre.

nID
[in] ID de la fenêtre enfant de la barre de rebar.

Valeur de retour

TRUE si la barre de rebar a été créée avec succès ; sinon, FALSE.

Notes

CMFCReBar ::GetReBarCtrl

Fournit un accès direct au CReBarCtrl contrôle commun sous-jacent pour CMFCReBar les objets.

CReBarCtrl& GetReBarCtrl() const;

Valeur de retour

Référence à l’objet sous-jacent CReBarCtrl .

Notes

Appelez cette méthode pour tirer parti de la fonctionnalité de contrôle commun de la barre windows lors de la personnalisation de votre barre de rebar.

CMFCReBar ::CalcFixedLayout

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Paramètres

[in] bStretch
[in] bHorz

Valeur de retour

Notes

CMFCReBar ::CanFloat

virtual BOOL CanFloat() const;

Valeur de retour

Notes

CMFCReBar ::EnableDocking

void EnableDocking(DWORD dwDockStyle);

Paramètres

[in] dwDockStyle

Notes

CMFCReBar ::GetReBarBandInfoSize

UINT GetReBarBandInfoSize() const;

Valeur de retour

Notes

CMFCReBar ::OnShowControlBarMenu

virtual BOOL OnShowControlBarMenu(CPoint);

Paramètres

[in] CPoint

Valeur de retour

Notes

CMFCReBar ::OnToolHitTest

virtual INT_PTR OnToolHitTest(
    CPoint point,
    TOOLINFO* pTI) const;

Paramètres

[in] point
[in] Pti

Valeur de retour

Notes

CMFCReBar ::OnUpdateCmdUI

virtual void OnUpdateCmdUI(
    CFrameWnd* pTarget,
    BOOL bDisableIfNoHndler);

Paramètres

[in] pTarget
[in] bDisableIfNoHndler

Notes

CMFCReBar ::SetPaneAlignment

virtual void SetPaneAlignment(DWORD dwAlignment);

Paramètres

[in] dwAlignment

Notes

Voir aussi

Graphique hiérarchique
Classes
CReBarCtrl, classe
CPane, classe