CReBarCtrl, classe

Article
10/12/2023

Encapsule les fonctionnalités d'un contrôle rebar, qui est un conteneur de fenêtre enfant.

Syntaxe

class CReBarCtrl : public CWnd

Membres

Constructeurs publics

Nom	Description
CReBarCtrl ::CReBarCtrl	Construit un objet `CReBarCtrl`.

Méthodes publiques

Nom	Description
CReBarCtrl ::BeginDrag	Place le contrôle rebar en mode glisser-déplacer.
CReBarCtrl ::Create	Crée le contrôle rebar et l’attache à l’objet `CReBarCtrl` .
CReBarCtrl ::CreateEx	Crée un contrôle de barre de nouveau avec les styles étendus Windows spécifiés et l’attache à un `CReBarCtrl` objet.
CReBarCtrl ::D eleteBand	Supprime une bande d’un contrôle de barre de rebar.
CReBarCtrl ::D ragMove	Met à jour la position de glisser dans le contrôle de barre de rebar après un appel à `BeginDrag`.
CReBarCtrl ::EndDrag	Met fin à l’opération de glisser-déplacer du contrôle rebar.
CReBarCtrl ::GetBandBorders	Récupère les bordures d’une bande.
CReBarCtrl ::GetBandCount	Récupère le nombre de bandes actuellement dans le contrôle de barre de rebar.
CReBarCtrl ::GetBandInfo	Récupère des informations sur une bande spécifiée dans un contrôle de barre de rebar.
CReBarCtrl ::GetBandMargins	Récupère les marges d’une bande.
CReBarCtrl ::GetBarHeight	Récupère la hauteur du contrôle de barre de rebar.
CReBarCtrl ::GetBarInfo	Récupère des informations sur le contrôle rebar et la liste d’images qu’il utilise.
CReBarCtrl ::GetBkColor	Récupère la couleur d’arrière-plan par défaut d’un contrôle rebar.
CReBarCtrl ::GetColorScheme	Récupère la structure COLORSCHEME associée au contrôle rebar.
CReBarCtrl ::GetDropTarget	Récupère le pointeur d’interface d’un `IDropTarget` contrôle rebar.
CReBarCtrl ::GetExtendedStyle	Obtient le style étendu du contrôle de barre de rebar actuel.
CReBarCtrl ::GetImageList	Récupère la liste d’images associée à un contrôle de barre de rebar.
CReBarCtrl ::GetPalette	Récupère la palette actuelle du contrôle rebar.
CReBarCtrl ::GetRect	Récupère le rectangle englobant d’une bande donnée dans un contrôle de barre de rebar.
CReBarCtrl ::GetRowCount	Récupère le nombre de lignes de bande dans un contrôle de barre de rebar.
CReBarCtrl ::GetRowHeight	Récupère la hauteur d’une ligne spécifiée dans un contrôle de barre de rebar.
CReBarCtrl ::GetTextColor	Récupère la couleur de texte par défaut d’un contrôle rebar.
CReBarCtrl ::GetToolTips	Récupère le handle sur n’importe quel contrôle d’info-bulle associé au contrôle de barre d’outils.
CReBarCtrl ::HitTest	Détermine la partie d’une bande de barres rebar à un point donné à l’écran, si une bande de barres de rebar existe à ce stade.
CReBarCtrl ::IDToIndex	Convertit un identificateur de bande (ID) en index de bande dans un contrôle de barre de rebar.
CReBarCtrl ::InsertBand	Insère une nouvelle bande dans un contrôle de barre de rebar.
CReBarCtrl ::MaximizeBand	Redimensionne une bande dans un contrôle de barre de rebar à sa plus grande taille.
CReBarCtrl ::MinimizeBand	Redimensionne une bande dans un contrôle de barre de rebar à sa plus petite taille.
CReBarCtrl ::MoveBand	Déplace une bande d’un index à un autre.
CReBarCtrl ::P ushChevron	Envoie par programmation un chevron.
CReBarCtrl ::RestoreBand	Redimensionne une bande dans un contrôle de barre de rebar à sa taille idéale.
CReBarCtrl ::SetBandInfo	Définit les caractéristiques d’une bande existante dans un contrôle de barre de rebar.
CReBarCtrl ::SetBandWidth	Définit la largeur de la bande ancrée spécifiée dans le contrôle de barre de rebar actuel.
CReBarCtrl ::SetBarInfo	Définit les caractéristiques d’un contrôle de barre de rebar.
CReBarCtrl ::SetBkColor	Définit la couleur d’arrière-plan par défaut d’un contrôle rebar.
CReBarCtrl ::SetColorScheme	Définit le jeu de couleurs pour les boutons d’un contrôle de barre de rebar.
CReBarCtrl ::SetExtendedStyle	Définit les styles étendus pour le contrôle de barre de rebar actuel.
CReBarCtrl ::SetImageList	Définit la liste d’images d’un contrôle rebar.
CReBarCtrl ::SetOwner	Définit la fenêtre propriétaire d’un contrôle rebar.
CReBarCtrl ::SetPalette	Définit la palette actuelle du contrôle rebar.
CReBarCtrl ::SetTextColor	Définit la couleur de texte par défaut d’un contrôle rebar.
CReBarCtrl ::SetToolTips	Associe un contrôle d’info-bulle au contrôle de barre d’outils.
CReBarCtrl ::SetWindowTheme	Définit le style visuel du contrôle rebar.
CReBarCtrl ::ShowBand	Affiche ou masque une bande donnée dans un contrôle de barre de rebar.
CReBarCtrl ::SizeToRect	Ajuste un contrôle de barre de rebar à un rectangle spécifié.

Notes

L’application dans laquelle réside le contrôle rebar affecte la fenêtre enfant contenue par le contrôle rebar à la bande de rebar. La fenêtre enfant est généralement un autre contrôle courant.

Les contrôles de barre de rebar contiennent une ou plusieurs bandes. Chaque bande peut contenir une combinaison d’une barre de gripper, d’une bitmap, d’une étiquette de texte et d’une fenêtre enfant. La bande ne peut contenir qu’un seul de ces éléments.

Le contrôle rebar peut afficher la fenêtre enfant sur une bitmap d’arrière-plan spécifiée. Toutes les bandes de contrôle de barre de rebar peuvent être redimensionnées, sauf celles qui utilisent le style RBBS_FIXEDSIZE. Lorsque vous repositionnez ou redimensionnez une bande de contrôle de barre de rebar, le contrôle rebar gère la taille et la position de la fenêtre enfant affectée à cette bande. Pour redimensionner ou modifier l’ordre des bandes dans le contrôle, cliquez et faites glisser la barre de pince d’une bande.

L’illustration suivante montre un contrôle de barre de rebar qui a trois bandes :

La bande 0 contient un contrôle de barre d’outils plat et transparent.
La bande 1 contient à la fois des boutons de liste déroulante transparents standard et transparents.
La bande 2 contient une zone de liste modifiable et quatre boutons standard.

Contrôle de la barre de rebar

Prise en charge des contrôles de barre de rebar :

Listes d’images.
Gestion des messages.
Fonctionnalité de dessin personnalisée.
Un large éventail de styles de contrôle en plus des styles de fenêtre standard. Pour obtenir la liste de ces styles, consultez Rebar Control Styles in the Windows SDK.

Pour plus d’informations, consultez Utilisation de CReBarCtrl.

Hiérarchie d'héritage

CObject

CCmdTarget

CWnd

CReBarCtrl

Spécifications

En-tête : afxcmn.h

CReBarCtrl ::BeginDrag

Implémente le comportement du message Win32 RB_BEGINDRAG, comme décrit dans le Kit de développement logiciel (SDK) Windows.

void BeginDrag(
    UINT uBand,
    DWORD dwPos = (DWORD)-1);

Paramètres

uBand
Index de base zéro de la bande affectée par l’opération de glisser-déplacer.

dwPos
Valeur DWORD qui contient les coordonnées de la souris de départ. La coordonnée horizontale est contenue dans le LOWORD, et la coordonnée verticale est contenue dans le HIWORD. Si vous passez (DWORD)-1, le contrôle de barre d’accès utilise la position de la souris la dernière fois que le thread du contrôle est appelé GetMessage ou PeekMessage.

CReBarCtrl ::Create

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

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Paramètres

dwStyle
Spécifie la combinaison de styles de contrôle rebar appliqués au contrôle. Pour obtenir la liste des styles pris en charge, consultez Styles de contrôle rebar dans le Kit de développement logiciel (SDK) Windows.

rect
Référence à un objet CRect ou à une structure RECT, qui est la position et la taille du contrôle de barre de rebar.

pParentWnd
Pointeur vers un objet CWnd qui est la fenêtre parente du contrôle rebar. Elle ne doit pas être NULL.

nID
Spécifie l’ID de contrôle du contrôle rebar.

Valeur de retour

Différent de zéro si l’objet a été créé avec succès ; sinon 0.

Notes

Créez un contrôle de barre de rebar en deux étapes :

Appelez CReBarCtrl pour construire un CReBarCtrl objet.
Appelez cette fonction membre, qui crée le contrôle de barre d’outils Windows et l’attache à l’objet CReBarCtrl .

Lorsque vous appelez Create, les contrôles courants sont initialisés.

Exemple

CReBarCtrl *pReBarCtrl = new CReBarCtrl();
CRect rect;
GetWindowRect(rect);
pReBarCtrl->Create(RBS_BANDBORDERS, rect, this, AFX_IDW_REBAR);

// Use ReBar Control.

delete pReBarCtrl;

CReBarCtrl ::CreateEx

Crée un contrôle (fenêtre enfant) et l’associe à l’objet CReBarCtrl .

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Paramètres

dwExStyle
Spécifie le style étendu du contrôle en cours de création. Pour obtenir la liste des styles Windows étendus, consultez le paramètre dwExStyle pour CreateWindowEx dans le Kit de développement logiciel (SDK) Windows.

dwStyle
Spécifie la combinaison de styles de contrôle rebar appliqués au contrôle. Pour obtenir la liste des styles pris en charge, consultez Rebar Control Styles in the Windows SDK.

rect
Référence à une structure RECT décrivant la taille et la position de la fenêtre à créer, dans les coordonnées clientes de pParentWnd.

pParentWnd
Pointeur vers la fenêtre qui est le parent du contrôle.

nID
ID de la fenêtre enfant du contrôle.

Valeur de retour

Valeur différente de zéro cas de réussite ; sinon, 0.

Notes

Utilisez CreateEx plutôt que Créer pour appliquer des styles Windows étendus, spécifiés par le préface de style étendu Windows WS_EX_.

CReBarCtrl ::CReBarCtrl

Crée un objet CReBarCtrl.

CReBarCtrl();

Exemple

Consultez l’exemple de CReBarCtrl ::Create.

CReBarCtrl ::D eleteBand

Implémente le comportement du message Win32 RB_DELETEBAND, comme décrit dans le Kit de développement logiciel (SDK) Windows.

BOOL DeleteBand(UINT uBand);

Paramètres

uBand
Index de base zéro de la bande à supprimer.

Valeur de retour

Différent de zéro si la bande a été supprimée avec succès ; sinon zéro.

Exemple

UINT nCount = m_wndReBar.GetReBarCtrl().GetBandCount();

if (nCount > 0)
   m_wndReBar.GetReBarCtrl().DeleteBand(nCount - 1);

CReBarCtrl ::D ragMove

Implémente le comportement du message Win32 RB_DRAGMOVE, comme décrit dans le Kit de développement logiciel (SDK) Windows.

void DragMove(DWORD dwPos = (DWORD)-1);

Paramètres

dwPos
Valeur DWORD qui contient les nouvelles coordonnées de la souris. La coordonnée horizontale est contenue dans le LOWORD, et la coordonnée verticale est contenue dans le HIWORD. Si vous passez (DWORD)-1, le contrôle de barre d’accès utilise la position de la souris la dernière fois que le thread du contrôle est appelé GetMessage ou PeekMessage.

CReBarCtrl ::EndDrag

Implémente le comportement du message Win32 RB_ENDDRAG, comme décrit dans le Kit de développement logiciel (SDK) Windows.

void EndDrag();

CReBarCtrl ::GetBandBorders

Implémente le comportement du message Win32 RB_GETBANDBORDERS, comme décrit dans le Kit de développement logiciel (SDK) Windows.

void GetBandBorders(
    UINT uBand,
    LPRECT prc) const;

Paramètres

uBand
Index de base zéro de la bande pour laquelle les bordures seront récupérées.

Rpc
Pointeur vers une structure RECT qui recevra les bordures de bande. Si le contrôle de barre de rebar a le style RBS_BANDBORDERS, chaque membre de cette structure reçoit le nombre de pixels, sur le côté correspondant de la bande, qui constitue la bordure. Si le contrôle de barre de rebar n’a pas le style RBS_BANDBORDERS, seul le membre gauche de cette structure reçoit des informations valides. Pour obtenir une description des styles de contrôle de barre de rebar, consultez Styles de contrôle rebar dans le Kit de développement logiciel (SDK) Windows.

CReBarCtrl ::GetBandCount

Implémente le comportement du message Win32 RB_GETBANDCOUNT, comme décrit dans le Kit de développement logiciel (SDK) Windows.

UINT GetBandCount() const;

Valeur de retour

Nombre de bandes affectées au contrôle.

CReBarCtrl ::GetBandInfo

Implémente le comportement du message Win32 RB_GETBANDINFO comme décrit dans le Kit de développement logiciel (SDK) Windows.

BOOL GetBandInfo(
    UINT uBand,
    REBARBANDINFO* prbbi) const;

Paramètres

uBand
Index de base zéro de la bande pour laquelle les informations seront récupérées.

prbbi
Pointeur vers une structure REBARBANDINFO pour recevoir les informations de bande. Vous devez définir le cbSize membre de cette structure sizeof(REBARBANDINFO) et définir le fMask membre sur les éléments à récupérer avant d’envoyer ce message.

Valeur de retour

Valeur différente de zéro en cas de réussite ; sinon, zéro.

CReBarCtrl ::GetBandMargins

Récupère les marges de la bande.

void GetBandMargins(PMARGINS pMargins);

Paramètres

pMargins
Pointeur vers une structure MARGEsqui recevra les informations.

Notes

Cette fonction membre émule les fonctionnalités du message RB_GETBANDMARGINS , comme décrit dans le Kit de développement logiciel (SDK) Windows.

CReBarCtrl ::GetBarHeight

Récupère la hauteur de la barre de barres de rebar.

UINT GetBarHeight() const;

Valeur de retour

Valeur qui représente la hauteur, en pixels, du contrôle.

CReBarCtrl ::GetBarInfo

Implémente le comportement du message Win32 RB_GETBARINFO, comme décrit dans le Kit de développement logiciel (SDK) Windows.

BOOL GetBarInfo(REBARINFO* prbi) const;

Paramètres

prbi
Pointeur vers une structure REBARINFO qui recevra les informations de contrôle de la barre de rebar. Vous devez définir le membre cbSize de cette structure sizeof(REBARINFO) avant d’envoyer ce message.

Valeur de retour

Valeur différente de zéro en cas de réussite ; sinon, zéro.

CReBarCtrl ::GetBkColor

Implémente le comportement du message Win32 RB_GETBKCOLOR, comme décrit dans le Kit de développement logiciel (SDK) Windows.

COLORREF GetBkColor() const;

Valeur de retour

Valeur COLORREF qui représente la couleur d’arrière-plan par défaut actuelle.

CReBarCtrl ::GetColorScheme

Récupère la structure COLORSCHEME pour le contrôle de barre de rebar.

BOOL GetColorScheme(COLORSCHEME* lpcs);

Paramètres

lpcs
Pointeur vers une structure COLORSCHEME , comme décrit dans le Kit de développement logiciel (SDK) Windows.

Valeur de retour

Valeur différente de zéro en cas de réussite ; sinon, zéro.

Notes

La COLORSCHEME structure inclut la couleur de surbrillance du bouton et la couleur de l’ombre du bouton.

CReBarCtrl ::GetDropTarget

Implémente le comportement du message Win32 RB_GETDROPTARGET, comme décrit dans le Kit de développement logiciel (SDK) Windows.

IDropTarget* GetDropTarget() const;

Valeur de retour

Pointeur vers une interface IDropTarget .

CReBarCtrl ::GetExtendedStyle

Obtient les styles étendus du contrôle de barre de rebar actuel.

DWORD GetExtendedStyle() const;

Valeur de retour

Combinaison de bits (OR) d’indicateurs qui indiquent les styles étendus. Les indicateurs possibles sont RBS_EX_SPLITTER et RBS_EX_TRANSPARENT. Pour plus d’informations, consultez le paramètre dwMask de la méthode CReBarCtrl ::SetExtendedStyle .

Notes

Cette méthode envoie le message RB_GETEXTENDEDSTYLE , qui est décrit dans le Kit de développement logiciel (SDK) Windows.

CReBarCtrl ::GetImageList

Obtient l’objet CImageList associé à un contrôle de barre de rebar.

CImageList* GetImageList() const;

Valeur de retour

Pointeur vers un objet CImageList . Retourne NULL si aucune liste d’images n’est définie pour le contrôle.

Notes

Cette fonction membre utilise des informations de taille et de masque stockées dans la structure REBARINFO , comme décrit dans le Kit de développement logiciel (SDK) Windows.

CReBarCtrl ::GetPalette

Récupère la palette actuelle du contrôle rebar.

CPalette* GetPalette() const;

Valeur de retour

Pointeur vers un objet CPalette spécifiant la palette actuelle du contrôle rebar.

Notes

Notez que cette fonction membre utilise un CPalette objet comme valeur de retour, plutôt qu’un HPALETTE.

Exemple

CPalette *pPalette = m_wndReBar.GetReBarCtrl().GetPalette();
if (pPalette)
{
   int nEntries = pPalette->GetEntryCount();
   CString msg;
   msg.Format(_T("Number of palette entries: %d"), nEntries);
   AfxMessageBox(msg);
}
else
{
   AfxMessageBox(_T("No palette!"));
}

CReBarCtrl ::GetRect

Implémente le comportement du message Win32 RB_GETRECT, comme décrit dans le Kit de développement logiciel (SDK) Windows.

BOOL GetRect(
    UINT uBand,
    LPRECT prc) const;

Paramètres

uBand
Index de base zéro d’une bande dans le contrôle de barre de rebar.

Rpc
Pointeur vers une structure RECT qui recevra les limites de la bande de barres de rebar.

Valeur de retour

Valeur différente de zéro en cas de réussite ; sinon, zéro.

Exemple

CRect rc;
m_wndReBar.GetReBarCtrl().GetRect(0, &rc);
CString msg;
msg.Format(_T("rect.left = %d, rect.top = %d, ")
           _T("rect.right = %d, rect.bottom = %d"),
           rc.left,
           rc.top, rc.right, rc.bottom);
AfxMessageBox(msg);

CReBarCtrl ::GetRowCount

Implémente le comportement du message Win32 RB_GETROWCOUNT, comme décrit dans le Kit de développement logiciel (SDK) Windows.

UINT GetRowCount() const;

Valeur de retour

Valeur UINT qui représente le nombre de lignes de bande dans le contrôle.

Exemple

UINT nRowCount = m_wndReBar.GetReBarCtrl().GetRowCount();
CString msg;
msg.Format(_T("Row Count is %d"), nRowCount);
AfxMessageBox(msg);

CReBarCtrl ::GetRowHeight

Implémente le comportement du message Win32 RB_GETROWHEIGHT, comme décrit dans le Kit de développement logiciel (SDK) Windows.

UINT GetRowHeight(UINT uRow) const;

Paramètres

uRow
Index de base zéro de la bande qui aura sa hauteur récupérée.

Valeur de retour

Valeur UINT qui représente la hauteur de ligne, en pixels.

Exemple

int nCount = m_wndReBar.GetReBarCtrl().GetRowCount();
for (int i = 0; i < nCount; i++)
{
   UINT nHeight = m_wndReBar.GetReBarCtrl().GetRowHeight(i);
   CString msg;
   msg.Format(_T("Height of row %d is %u"), i, nHeight);
   AfxMessageBox(msg);
}

CReBarCtrl ::GetTextColor

Implémente le comportement du message Win32 RB_GETTEXTCOLOR, comme décrit dans le Kit de développement logiciel (SDK) Windows.

COLORREF GetTextColor() const;

Valeur de retour

Valeur COLORREF qui représente la couleur de texte par défaut actuelle.

CReBarCtrl ::GetToolTips

Implémente le comportement du message Win32 RB_GETTOOLTIPS, comme décrit dans le Kit de développement logiciel (SDK) Windows.

CToolTipCtrl* GetToolTips() const;

Valeur de retour

Pointeur vers un objet CToolTipCtrl .

Notes

Notez que l’implémentation MFC de GetToolTips retourne un pointeur vers un CToolTipCtrlpointeur plutôt qu’un HWND.

CReBarCtrl ::HitTest

Implémente le comportement du message Win32 RB_HITTEST, comme décrit dans le Kit de développement logiciel (SDK) Windows.

int HitTest(RBHITTESTINFO* prbht);

Paramètres

prbht
Pointeur vers une structure RBHITTESTINFO . Avant d’envoyer le message, le pt membre de cette structure doit être initialisé au point qui sera testé, dans les coordonnées du client.

Valeur de retour

Index de base zéro de la bande au point donné, ou -1 si aucune bande de barres de rebar n’était au point.

CReBarCtrl ::IDToIndex

Implémente le comportement du message Win32 RB_IDTOINDEX, comme décrit dans le Kit de développement logiciel (SDK) Windows.

int IDToIndex(UINT uBandID) const;

Paramètres

uBandID
Identificateur défini par l’application de la bande spécifiée, passé dans le membre de la wID structure REBARBANDINFO lorsque la bande est insérée.

Valeur de retour

Index de bande de base zéro s’il réussit ou -1 sinon. Si des index de bande en double existent, le premier est retourné.

CReBarCtrl ::InsertBand

Implémente le comportement du message Win32 RB_INSERTBAND, comme décrit dans le Kit de développement logiciel (SDK) Windows.

BOOL InsertBand(
    UINT uIndex,
    REBARBANDINFO* prbbi);

Paramètres

uIndex
Index de base zéro de l’emplacement où la bande sera insérée. Si vous définissez ce paramètre sur -1, le contrôle ajoute la nouvelle bande au dernier emplacement.

prbbi
Pointeur vers une structure REBARBANDINFO qui définit la bande à insérer. Vous devez définir le membre cbSize de cette structure sizeof(REBARBANDINFO) avant d’appeler cette fonction.

Valeur de retour

Valeur différente de zéro en cas de réussite ; sinon, zéro.

Exemple

REBARBANDINFO rbbi = {0};
rbbi.cbSize = sizeof(rbbi);

TCHAR szText[80];
rbbi.lpText = szText;
rbbi.cch = sizeof(szText) / sizeof(szText[0]);

rbbi.fMask = RBBIM_BACKGROUND | RBBIM_CHILD |
             RBBIM_CHILDSIZE | RBBIM_COLORS | RBBIM_HEADERSIZE |
             RBBIM_IDEALSIZE | RBBIM_ID | RBBIM_IMAGE |
             RBBIM_LPARAM | RBBIM_SIZE | RBBIM_STYLE | RBBIM_TEXT;

m_wndReBar.GetReBarCtrl().GetBandInfo(0, &rbbi);

m_wndReBar.GetReBarCtrl().InsertBand(1, &rbbi);

CReBarCtrl ::MaximizeBand

Redimensionne une bande dans un contrôle de barre de rebar à sa plus grande taille.

void MaximizeBand(UINT uBand);

Paramètres

uBand
Index de base zéro de la bande à agrandir.

Notes

Implémente le comportement du message Win32 RB_MAXIMIZEBAND avec fIdeal la valeur 0, comme décrit dans le Kit de développement logiciel (SDK) Windows.

Exemple

CReBarCtrl& refReBarCtrl = m_wndReBar.GetReBarCtrl();
UINT nCount = refReBarCtrl.GetBandCount();

for (UINT i = 0; i < nCount; i++)
   refReBarCtrl.MaximizeBand(i);

CReBarCtrl ::MinimizeBand

Redimensionne une bande dans un contrôle de barre de rebar à sa plus petite taille.

void MinimizeBand(UINT uBand);

Paramètres

uBand
Index de base zéro de la bande à réduire.

Notes

Implémente le comportement du message Win32 RB_MINIMIZEBAND, comme décrit dans le Kit de développement logiciel (SDK) Windows.

Exemple

CReBarCtrl &refReBarCtrl = m_wndReBar.GetReBarCtrl();
UINT nCount = refReBarCtrl.GetBandCount();

for (UINT i = 0; i < nCount; i++)
   refReBarCtrl.MinimizeBand(i);

CReBarCtrl ::MoveBand

Implémente le comportement du message Win32 RB_MOVEBAND, comme décrit dans le Kit de développement logiciel (SDK) Windows.

BOOL MoveBand(
    UINT uFrom,
    UINT uTo);

Paramètres

uFrom
Index de base zéro de la bande à déplacer.

uTo
Index de base zéro de la nouvelle position de bande. Cette valeur de paramètre ne doit jamais être supérieure au nombre de bandes moins une. Pour obtenir le nombre de bandes, appelez GetBandCount.

Valeur de retour

Valeur différente de zéro en cas de réussite ; sinon, zéro.

CReBarCtrl ::P ushChevron

Implémente le comportement du message Win32 RB_PUSHCHEVRON, comme décrit dans le Kit de développement logiciel (SDK) Windows.

void PushChevron(
    UINT uBand,
    LPARAM lAppValue);

Paramètres

uBand
Index de base zéro de la bande dont le chevron doit être poussé.

lAppValue
Valeur 32 bits définie par une application. Consultez lAppValue dans RB_PUSHCHEVRON dans le Kit de développement logiciel (SDK) Windows.

CReBarCtrl ::RestoreBand

Redimensionne une bande dans un contrôle de barre de rebar à sa taille idéale.

void RestoreBand(UINT uBand);

Paramètres

uBand
Index de base zéro de la bande à agrandir.

Notes

Implémente le comportement du message Win32 RB_MAXIMIZEBAND avec fIdeal la valeur 1, comme décrit dans le Kit de développement logiciel (SDK) Windows.

Exemple

CReBarCtrl &refReBarCtrl = m_wndReBar.GetReBarCtrl();
UINT nCount = refReBarCtrl.GetBandCount();

for (UINT i = 0; i < nCount; i++)
   refReBarCtrl.RestoreBand(i);

CReBarCtrl ::SetBandInfo

Implémente le comportement du message Win32 RB_SETBANDINFO, comme décrit dans le Kit de développement logiciel (SDK) Windows.

BOOL SetBandInfo(
    UINT uBand,
    REBARBANDINFO* prbbi);

Paramètres

uBand
Index de base zéro de la bande pour recevoir les nouveaux paramètres.

prbbi
Pointeur vers une structure REBARBANDINFO qui définit la bande à insérer. Vous devez définir le cbSize membre de cette structure sizeof(REBARBANDINFO) avant d’envoyer ce message.

Valeur de retour

Valeur différente de zéro en cas de réussite ; sinon, zéro.

Exemple

int nCount = m_wndReBar.GetReBarCtrl().GetBandCount();
CString strText;
REBARBANDINFO rbbi = {0};
rbbi.cbSize = sizeof(rbbi);
for (int i = 0; i < nCount; i++)
{
   strText.Format(_T("Band #: %d"), i);
   rbbi.lpText = strText.GetBuffer();
   rbbi.cch = strText.GetLength() + 1;
   rbbi.fMask = RBBIM_TEXT;

   m_wndReBar.GetReBarCtrl().SetBandInfo(i, &rbbi);

   strText.ReleaseBuffer();
}

CReBarCtrl ::SetBandWidth

Définit la largeur de la bande ancrée spécifiée dans le contrôle de barre de rebar actuel.

BOOL SetBandWidth(
    UINT uBand,
    int cxWidth);

Paramètres

uBand
[in] Index de base zéro d’une bande de barres.

cxWidth
[in] Nouvelle largeur de la bande de barres de rebar, en pixels.

Valeur de retour

TRUE si la méthode réussit ; sinon, FALSE.

Notes

Cette méthode envoie le message RB_SETBANDWIDTH , qui est décrit dans le Kit de développement logiciel (SDK) Windows.

Exemple

Le premier exemple de code définit la variable, m_rebarutilisée pour accéder au contrôle de barre de rebar actuel. Cette variable est utilisée dans l'exemple suivant.

public:
CReBarCtrl m_rebar;
BOOL bRet;
static const int TOTAL_BANDS = 5;
static const int BUFFER_SIZE = 10;

L’exemple de code suivant définit chaque bande de barres de rebar de la même largeur.

// Set the width of each band.
m_rebar.GetClientRect(&rect);
int iWidth = rect.Width() / TOTAL_BANDS;
for (int iIndex = 0; iIndex < TOTAL_BANDS; iIndex++)
   bRet = m_rebar.SetBandWidth(iIndex, iWidth);

CReBarCtrl ::SetBarInfo

Implémente le comportement du message Win32 RB_SETBARINFO, comme décrit dans le Kit de développement logiciel (SDK) Windows.

BOOL SetBarInfo(REBARINFO* prbi);

Paramètres

prbi
Pointeur vers une structure REBARINFO qui contient les informations à définir. Vous devez définir le cbSize membre de cette structure sizeof(REBARINFO) avant d’envoyer ce message

Valeur de retour

Valeur différente de zéro en cas de réussite ; sinon, zéro.

Exemple

REBARINFO rbi = {0};
rbi.cbSize = sizeof(REBARINFO);
rbi.fMask = 0;
rbi.himl = 0;
m_wndReBar.GetReBarCtrl().SetBarInfo(&rbi);

CReBarCtrl ::SetBkColor

Implémente le comportement du message Win32 RB_SETBKCOLOR, comme décrit dans le Kit de développement logiciel (SDK) Windows.

COLORREF SetBkColor(COLORREF clr);

Paramètres

clr
Valeur COLORREF qui représente la nouvelle couleur d’arrière-plan par défaut.

Valeur de retour

Valeur COLORREF qui représente la couleur d’arrière-plan par défaut précédente.

Notes

Pour plus d’informations sur le moment où définir la couleur d’arrière-plan et comment définir la valeur par défaut, consultez cette rubrique.

CReBarCtrl ::SetColorScheme

Définit le jeu de couleurs pour les boutons d’un contrôle de barre de rebar.

void SetColorScheme(const COLORSCHEME* lpcs);

Paramètres

lpcs
Pointeur vers une structure COLORSCHEME , comme décrit dans le Kit de développement logiciel (SDK) Windows.

Notes

La COLORSCHEME structure inclut à la fois la couleur de surbrillance du bouton et la couleur d’ombre du bouton.

CReBarCtrl ::SetExtendedStyle

Définit les styles étendus pour le contrôle de barre de rebar actuel.

DWORD SetExtendedStyle(
    DWORD dwMask,
    DWORD dwStyleEx);

Paramètres

dwMask
[in] Combinaison de bits (OR) d’indicateurs qui spécifient les indicateurs dans le paramètre dwStyleEx s’appliquent. Utilisez une ou plusieurs des valeurs suivantes :

RBS_EX_SPLITTER: par défaut, affichez le séparateur en bas en mode horizontal et à droite en mode vertical.
RBS_EX_TRANSPARENT: transférez le message WM_ERASEBKGND à la fenêtre parente.

dwStyleEx
[in] Combinaison de bits (OR) d’indicateurs qui spécifient les styles à appliquer. Pour définir un style, spécifiez le même indicateur que celui utilisé dans le paramètre dwMask . Pour réinitialiser un style, spécifiez un zéro binaire.

Valeur de retour

Style étendu précédent.

Notes

Cette méthode envoie le message RB_SETEXTENDEDSTYLE , qui est décrit dans le Kit de développement logiciel (SDK) Windows.

CReBarCtrl ::SetImageList

Affecte une liste d’images à un contrôle de barre de rebar.

BOOL SetImageList(CImageList* pImageList);

Paramètres

pImageList
Pointeur vers un objet CImageList contenant la liste d’images à affecter au contrôle de barre de rebar.

Valeur de retour

Valeur différente de zéro en cas de réussite ; sinon, zéro.

CReBarCtrl ::SetOwner

Implémente le comportement du message Win32 RB_SETPARENT, comme décrit dans le Kit de développement logiciel (SDK) Windows.

CWnd* SetOwner(CWnd* pWnd);

Paramètres

pWnd
Pointeur vers un CWnd objet à définir en tant que propriétaire du contrôle de barre de rebar.

Valeur de retour

Pointeur vers un objet CWnd qui est le propriétaire actuel du contrôle rebar.

Notes

Notez que cette fonction membre utilise des pointeurs vers CWnd des objets pour le propriétaire actuel et sélectionné du contrôle rebar, plutôt que des handles vers des fenêtres.

Remarque

Cette fonction membre ne modifie pas le parent réel qui a été défini lors de la création du contrôle ; il envoie plutôt des messages de notification à la fenêtre que vous spécifiez.

CReBarCtrl ::SetPalette

Implémente le comportement du message Win32 RB_SETPALETTE, comme décrit dans le Kit de développement logiciel (SDK) Windows.

CPalette* SetPalette(HPALETTE hPal);

Paramètres

hPal
HPALETTE qui spécifie la nouvelle palette que le contrôle de barre de rebar utilisera.

Valeur de retour

Pointeur vers un objet CPalette spécifiant la palette précédente du contrôle rebar.

Notes

Notez que cette fonction membre utilise un CPalette objet comme valeur de retour, plutôt qu’un HPALETTE.

CReBarCtrl ::SetTextColor

Implémente le comportement du message Win32 RB_SETTEXTCOLOR, comme décrit dans le Kit de développement logiciel (SDK) Windows.

COLORREF SetTextColor(COLORREF clr);

Paramètres

clr
Valeur COLORREF qui représente la nouvelle couleur de texte dans l’objet CReBarCtrl .

Valeur de retour

Valeur COLORREF représentant la couleur de texte précédente associée à l’objet CReBarCtrl .

Notes

Il est fourni pour prendre en charge la flexibilité des couleurs de texte dans un contrôle de barre de rebar.

CReBarCtrl ::SetToolTips

Associe un contrôle info-bulle à un contrôle de barre d’outils.

void SetToolTips(CToolTipCtrl* pToolTip);

Paramètres

pToolTip
Pointeur vers un objet CToolTipCtrl

Notes

Vous devez détruire l’objet CToolTipCtrl lorsque vous en avez terminé.

CReBarCtrl ::SetWindowTheme

Définit le style visuel du contrôle rebar.

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

Paramètres

pszSubAppName
Pointeur vers une chaîne Unicode qui contient le style visuel de la barre de rebar à définir.

Valeur de retour

La valeur de retour n’est pas utilisée.

Notes

Cette fonction membre émule les fonctionnalités du message RB_SETWINDOWTHEME , comme décrit dans le Kit de développement logiciel (SDK) Windows.

CReBarCtrl ::ShowBand

Implémente le comportement du message Win32 RB_SHOWBAND, comme décrit dans le Kit de développement logiciel (SDK) Windows.

BOOL ShowBand(
    UINT uBand,
    BOOL fShow = TRUE);

Paramètres

uBand
Index de base zéro d’une bande dans le contrôle de barre de rebar.

fShow
Indique si la bande doit être affichée ou masquée. Si cette valeur est TRUE, la bande s’affiche. Sinon, le groupe sera masqué.

Valeur de retour

Valeur différente de zéro en cas de réussite ; sinon, zéro.

CReBarCtrl ::SizeToRect

Implémente le comportement du message Win32 RB_SIZETORECT, comme décrit dans le Kit de développement logiciel (SDK) Windows.

BOOL SizeToRect(CRect& rect);

Paramètres

rect
Référence à un objet CRect qui spécifie le rectangle auquel le contrôle de barre de rebar doit être dimensionné.

Valeur de retour

Valeur différente de zéro en cas de réussite ; sinon, zéro.

Notes

Notez que cette fonction membre utilise un CRect objet comme paramètre, plutôt qu’une RECT structure.

Voir aussi

CWnd, classe
Graphique hiérarchique

Partager via

CReBarCtrl, classe

Syntaxe

Membres

Constructeurs publics

Méthodes publiques

Notes

Contrôle de la barre de rebar

Hiérarchie d'héritage

Spécifications

CReBarCtrl ::BeginDrag

Paramètres

CReBarCtrl ::Create

Paramètres

Valeur de retour

Notes

Exemple

CReBarCtrl ::CreateEx

Paramètres

Valeur de retour

Notes

CReBarCtrl ::CReBarCtrl

Exemple

CReBarCtrl ::D eleteBand

Paramètres

Valeur de retour

Exemple

CReBarCtrl ::D ragMove

Paramètres

CReBarCtrl ::EndDrag

CReBarCtrl ::GetBandBorders

Paramètres

CReBarCtrl ::GetBandCount

Valeur de retour

CReBarCtrl ::GetBandInfo

Paramètres

Valeur de retour

CReBarCtrl ::GetBandMargins

Paramètres

Notes

CReBarCtrl ::GetBarHeight

Valeur de retour

CReBarCtrl ::GetBarInfo

Paramètres

Valeur de retour

CReBarCtrl ::GetBkColor

Valeur de retour

CReBarCtrl ::GetColorScheme

Paramètres

Valeur de retour

Notes

CReBarCtrl ::GetDropTarget

Valeur de retour

CReBarCtrl ::GetExtendedStyle

Valeur de retour

Notes

CReBarCtrl ::GetImageList

Valeur de retour

Notes

CReBarCtrl ::GetPalette

Valeur de retour

Notes

Exemple

CReBarCtrl ::GetRect

Paramètres

Valeur de retour

Exemple

CReBarCtrl ::GetRowCount

Valeur de retour

Exemple

CReBarCtrl ::GetRowHeight

Paramètres

Valeur de retour

Exemple

CReBarCtrl ::GetTextColor

Valeur de retour

CReBarCtrl ::GetToolTips

Valeur de retour

Notes

CReBarCtrl ::HitTest