Structure REBARBANDINFOA (commctrl.h)

  • Article

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
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
 Les membres cxMinChild, cyMinChild, cyChild, cyMaxChild et 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 membre wID 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
 L’image bitmap d’arrière-plan ne se déplace pas lorsque la bande est redimensionnée.
RBBS_FIXEDSIZE
 La bande ne peut pas être dimensionnée. Avec ce style, la poignée de dimensionnement n’est pas affichée sur la bande.
RBBS_GRIPPERALWAYS

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.
RBBS_HIDDEN
 La bande ne sera pas visible.
RBBS_NOGRIPPER

Version 4.71. La bande n’aura jamais de prise de dimensionnement, même s’il y a plusieurs bandes dans la barre.
RBBS_USECHEVRON

Version 5.80. Affichez un bouton chevron si la bande est plus petite que cxIdeal.
RBBS_VARIABLEHEIGHT

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.
RBBS_NOVERT
 N’affichez pas quand il est vertical.
RBBS_HIDETITLE
 Gardez le titre du groupe masqué.
RBBS_TOPALIGN
 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