Structure REBARBANDINFOA (commctrl.h)
Contient des informations qui définissent une bande dans un contrôle de barre d’armature.
Syntaxe
typedef struct tagREBARBANDINFOA {
UINT cbSize;
UINT fMask;
UINT fStyle;
COLORREF clrFore;
COLORREF clrBack;
LPSTR lpText;
UINT cch;
int iImage;
HWND hwndChild;
UINT cxMinChild;
UINT cyMinChild;
UINT cx;
HBITMAP hbmBack;
UINT wID;
UINT cyChild;
UINT cyMaxChild;
UINT cyIntegral;
UINT cxIdeal;
LPARAM lParam;
UINT cxHeader;
RECT rcChevronLocation;
UINT uChevronState;
} REBARBANDINFOA, *LPREBARBANDINFOA;
Membres
cbSize
Type : UINT
Taille de cette structure, en octets. Votre application doit remplir ce membre avant d’envoyer des messages qui utilisent l’adresse de cette structure comme paramètre.
fMask
Type : UINT
Indicateurs qui indiquent quels membres de cette structure sont valides ou doivent être remplis. Cette valeur peut être une combinaison des éléments suivants :
Valeur | Signification |
---|---|
|
Le membre hbmBack est valide ou doit être défini. |
|
Le membre hwndChild est valide ou doit être défini. |
|
Les membres cxMinChild, cyMinChild, cyChild, cyMaxChild et cyIntegral sont valides ou doivent être définis. |
|
Les membres clrFore et clrBack sont valides ou doivent être définis. |
|
Version 4.71. Le membre cxHeader est valide ou doit être défini. |
|
Version 4.71. Le membre cxIdeal est valide ou doit être défini. |
|
Le membre wID est valide ou doit être défini. |
|
Le membre iImage est valide ou doit être défini. |
|
Version 4.71. Le membre lParam est valide ou doit être défini. |
|
Le membre cx est valide ou doit être défini. |
|
Le membre fStyle est valide ou doit être défini. |
|
Le membre lpText est valide ou doit être défini. |
|
Le membre rcChevronLocation est valide ou doit être défini. |
|
Le membre uChevronState est valide ou doit être défini. |
fStyle
Type : UINT
Indicateurs qui spécifient le style de bande. Cette valeur peut être une combinaison des éléments suivants :
Valeur | Signification |
---|---|
|
Le groupe est sur une nouvelle ligne. |
|
La bande a un bord en haut et en bas de la fenêtre enfant. |
|
L’image bitmap d’arrière-plan ne se déplace pas lorsque la bande est redimensionnée. |
|
La bande ne peut pas être dimensionnée. Avec ce style, la poignée de dimensionnement n’est pas affichée sur la bande. |
|
Version 4.71. La bande aura toujours une poignée de dimensionnement, même s’il s’agit de la seule bande dans la barre. |
|
La bande ne sera pas visible. |
|
Version 4.71. La bande n’aura jamais de prise de dimensionnement, même s’il y a plusieurs bandes dans la barre. |
|
Version 5.80. Affichez un bouton chevron si la bande est plus petite que cxIdeal. |
|
Version 4.71. La bande peut être redimensionnée par le contrôle de barre d’armature ; cyIntegral et cyMaxChild affectent la façon dont la barre d’barres redimensionne la bande. |
|
N’affichez pas quand il est vertical. |
|
Gardez le titre du groupe masqué. |
|
Conservez la bande dans la ligne supérieure. |
clrFore
Type : COLORREF
Couleurs de premier plan de la bande.
clrBack
Type : COLORREF
Couleurs d’arrière-plan de la bande. Si hbmBack spécifie une image bitmap d’arrière-plan, ces membres sont ignorés. Par défaut, la bande utilise la couleur d’arrière-plan du contrôle de barre d’armature défini avec le message RB_SETBKCOLOR . Si une couleur d’arrière-plan est spécifiée ici, cette couleur d’arrière-plan sera utilisée à la place.
lpText
Type : LPTSTR
Pointeur vers une mémoire tampon qui contient le texte d’affichage de la bande. Si des informations de bande sont demandées au contrôle et que RBBIM_TEXT est spécifié dans fMask, ce membre doit être initialisé à l’adresse de la mémoire tampon qui recevra le texte.
cch
Type : UINT
Taille de la mémoire tampon au niveau de lpText, en octets. Si aucune information n’est demandée au contrôle, ce membre est ignoré.
iImage
Type : int
Index de base zéro de toute image qui doit être affichée dans la bande. La liste d’images est définie à l’aide du message RB_SETBARINFO .
hwndChild
Type : HWND
Gérez la fenêtre enfant contenue dans la bande, le cas échéant.
cxMinChild
Type : UINT
Largeur minimale de la fenêtre enfant, en pixels. La bande ne peut pas être dimensionnée plus petite que cette valeur.
cyMinChild
Type : UINT
Hauteur minimale de la fenêtre enfant, en pixels. La bande ne peut pas être dimensionnée plus petite que cette valeur.
cx
Type : UINT
Longueur de la bande, en pixels.
hbmBack
Type : HBITMAP
Gérez une bitmap utilisée comme arrière-plan pour cette bande.
wID
Type : UINT
Valeur UINT que le contrôle utilise pour identifier cette bande pour les messages de notification de dessin personnalisés.
cyChild
Type : UINT
Version 4.71. Hauteur initiale de la bande, en pixels. Ce membre est ignoré, sauf si le style RBBS_VARIABLEHEIGHT est spécifié.
cyMaxChild
Type : UINT
Version 4.71. Hauteur maximale de la bande, en pixels. Ce membre est ignoré, sauf si le style RBBS_VARIABLEHEIGHT est spécifié.
cyIntegral
Type : UINT
Version 4.71. Valeur d’étape par laquelle la bande peut croître ou réduire, en pixels. Si la bande est redimensionnée, elle est redimensionnée selon les étapes spécifiées par cette valeur. Ce membre est ignoré, sauf si le style RBBS_VARIABLEHEIGHT est spécifié.
cxIdeal
Type : UINT
Version 4.71. Largeur idéale de la bande, en pixels. Si la bande est agrandie jusqu’à la largeur idéale (voir RB_MAXIMIZEBAND), le contrôle de barre d’barres d’barres tente d’obtenir cette largeur.
lParam
Type : LPARAM
Version 4.71. Valeur définie par l’application.
cxHeader
Type : UINT
Version 4.71. Taille de l’en-tête de la bande, en pixels. L’en-tête de bande est la zone entre le bord de la bande et le bord de la fenêtre enfant. Il s’agit de la zone où le texte de bande et les images sont affichés, s’ils sont spécifiés. Si cette valeur est spécifiée, elle remplace les dimensions d’en-tête normales calculées par le contrôle pour la bande.
rcChevronLocation
Type : RECT
Version 6. Emplacement du chevron.
uChevronState
Type : UINT
Version 6. Combinaison des constantes d’état d’objet.
Remarques
Les membres cxMinChild, cyMinChild et cx fournissent des informations sur les dimensions relatives à l’orientation du contrôle. Autrement dit, pour un contrôle de barre d’barres horizontales, cxMinChild et cx sont des mesures horizontales et cyMinChild est une mesure verticale. Toutefois, si le contrôle utilise le style CCS_VERT , cxMinChild et cx sont des mesures verticales et cyMinChild est une mesure horizontale.
Notes
L’en-tête commctrl.h définit REBARBANDINFO en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
En-tête | commctrl.h |