Structure TBBUTTON (commctrl.h)

  • Article

Contient des informations sur un bouton dans une barre d’outils.

Syntaxe

typedef struct _TBBUTTON {
  int       iBitmap;
  int       idCommand;
  BYTE      fsState;
  BYTE      fsStyle;
#if ...
  BYTE      bReserved[6];
#else
  BYTE      bReserved[2];
#endif
  DWORD_PTR dwData;
  INT_PTR   iString;
} TBBUTTON, *PTBBUTTON, *LPTBBUTTON;

Membres

iBitmap

Type : int

Index de base zéro de l’image de bouton. Définissez ce membre sur I_IMAGECALLBACK, et la barre d’outils envoie le code de notification TBN_GETDISPINFO pour récupérer l’index d’image quand cela est nécessaire.

Version 5.81. Définissez ce membre sur I_IMAGENONE pour indiquer que le bouton n’a pas d’image. La disposition du bouton n’inclut pas d’espace pour une bitmap, mais uniquement du texte.

Si le bouton est un séparateur, c’est-à-dire si fsStyle est défini sur BTNS_SEP, iBitmap détermine la largeur du séparateur, en pixels. Pour plus d’informations sur la sélection d’images de bouton à partir de listes d’images, consultez TB_SETIMAGELIST message.

idCommand

Type : int

Identificateur de commande associé au bouton. Cet identificateur est utilisé dans un message WM_COMMAND lorsque le bouton est choisi.

fsState

Type : BYTE

Indicateurs d’état de bouton. Ce membre peut être une combinaison des valeurs répertoriées dans États du bouton de barre d’outils.

fsStyle

Type : BYTE

Style de bouton. Ce membre peut être une combinaison des valeurs de style de bouton répertoriées dans Contrôle de barre d’outils et Styles de bouton.

bReserved[6]

Type : BYTE

Réservé.

bReserved[2]

Type : BYTE

Réservé.

dwData

Type : DWORD_PTR

Valeur définie par l’application.

iString

Type : INT_PTR

Index de base zéro de la chaîne de bouton ou pointeur vers une mémoire tampon de chaîne qui contient le texte du bouton.

Remarques

Le membre iString peut retourner un pointeur de chaîne ou un index. Vous pouvez utiliser la macro IS_INTRESOURCE pour déterminer laquelle est retournée.

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