CReBarCtrl, classe
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 | Mises à 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 ::GetTool Astuces | 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 ::SetTool Astuces | 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
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 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
CReBarCtrlobjet.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 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_GETo ANDBORDERS, 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_GETo ANDCOUNT, 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_GETo ANDINFO, 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_GETo ANDMARGINS, 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_GETo ARINFO, 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_GETo KCOLOR, 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
Retard
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 ::GetTool Astuces
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 wIDstructure 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_INSERTo AND, 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_SETo ANDINFO, 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_SETo ANDWIDTH, 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_SETo ARINFO, 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_SETo KCOLOR, 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
Retard
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 ::SetTool Astuces
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
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour