Structure REBARBANDINFOA (commctrl.h)

Article
11/18/2024

Contient des informations qui définissent une bande dans un contrôle de barre de rebar.

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 en tant que 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
RBBIM_BACKGROUND	Le membre hbmBack est valide ou doit être défini.
RBBIM_CHILD	Le membre hwndChild est valide ou doit être défini.
RBBIM_CHILDSIZE	LecxMinChild , cyMinChild, cyChild, cyMaxChildet membres cyIntegral sont valides ou doivent être définis.
RBBIM_COLORS	Les membres clrFore et clrBack sont valides ou doivent être définis.
RBBIM_HEADERSIZE	version 4.71. Le membre cxHeader est valide ou doit être défini.
RBBIM_IDEALSIZE	version 4.71. Le membre cxIdeal est valide ou doit être défini.
RBBIM_ID	Le wID membre est valide ou doit être défini.
RBBIM_IMAGE	Le membre iImage est valide ou doit être défini.
RBBIM_LPARAM	version 4.71. Le membre lParam est valide ou doit être défini.
RBBIM_SIZE	Le membre cx est valide ou doit être défini.
RBBIM_STYLE	Le membre fStyle est valide ou doit être défini.
RBBIM_TEXT	Le membre lpText est valide ou doit être défini.
RBBIM_CHEVRONLOCATION	Le membre rcChevronLocation est valide ou doit être défini.
RBBIM_CHEVRONSTATE	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
RBBS_BREAK	Le groupe est sur une nouvelle ligne.
RBBS_CHILDEDGE	La bande a un bord en haut et en bas de la fenêtre enfant.
RBBS_FIXEDBMP	La bitmap d’arrière-plan ne se déplace pas lorsque la bande est redimensionnée.
RBBS_FIXEDSIZE	Le groupe ne peut pas être dimensionné. Avec ce style, la poignée de dimensionnement n’est pas affichée sur la bande.
RBBS_GRIPPERALWAYS	version 4.71. Le groupe aura toujours une poignée de dimensionnement, même s’il s’agit de la seule bande dans la barre de rebar.
RBBS_HIDDEN	La bande ne sera pas visible.
RBBS_NOGRIPPER	version 4.71. Le groupe n’aura jamais de poignée de dimensionnement, même s’il y a plusieurs bandes dans la barre de rebar.
RBBS_USECHEVRON	Version 5.80. Afficher un bouton chevron si la bande est inférieure à cxIdeal.
RBBS_VARIABLEHEIGHT	version 4.71. La bande peut être redimensionnée par le contrôle de barre de rebar ; cyIntegral et cyMaxChild affecter la façon dont la barre de rebar redimensionnera la bande.
RBBS_NOVERT	Ne pas afficher quand il est vertical.
RBBS_HIDETITLE	Conservez le titre de bande masqué.
RBBS_TOPALIGN	Conservez la bande dans la ligne supérieure.

clrFore

Type : COLORREF

Couleurs de premier plan de bande.

clrBack

Type : COLORREF

Couleurs d’arrière-plan de bande. Si hbmBack spécifie une 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 rebar 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 les informations de bande sont demandées à partir du contrôle et que RBBIM_TEXT est spécifiée 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 à lpText, en octets. Si les informations ne sont pas demandées à partir du 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 utilisée par le contrôle 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 dans 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 à la largeur idéale (voir RB_MAXIMIZEBAND), le contrôle de barre de rebar tentera de faire de la bande 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 et les images de bande 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, cyMinChildet cx fournissent des informations sur les dimensions relatives à l’orientation du contrôle. Autrement dit, pour un contrôle de barre horizontale, 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.

Note

L’en-tête commctrl.h définit REBARBANDINFO comme 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. Le mélange 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
d’en-tête	commctrl.h

Partager via

Structure REBARBANDINFOA (commctrl.h)

Syntaxe

Membres

Remarques

Exigences

Commentaires

Ressources supplémentaires