TbBUTTONINFOW, structure (commctrl.h)

Contient ou reçoit des informations pour un bouton spécifique dans une barre d’outils.

Syntaxe

typedef struct {
  UINT      cbSize;
  DWORD     dwMask;
  int       idCommand;
  int       iImage;
  BYTE      fsState;
  BYTE      fsStyle;
  WORD      cx;
  DWORD_PTR lParam;
  LPWSTR    pszText;
  int       cchText;
} TBBUTTONINFOW, *LPTBBUTTONINFOW;

Membres

cbSize

Type : UINT

Taille de la structure, en octets. Ce membre doit être renseigné avant d’envoyer le message associé.

dwMask

Type : DWORD

Ensemble d’indicateurs qui indiquent quels membres contiennent des informations valides. Ce membre doit être renseigné avant d’envoyer le message associé. Il peut s’agir d’une ou plusieurs des valeurs suivantes.

Valeur Signification
TBIF_BYINDEX

Version 5.80. Le wParam envoyé avec un message TB_GETBUTTONINFO ou TB_SETBUTTONINFO est un index, et non un identificateur.

TBIF_COMMAND
Le membre idCommand contient des informations valides ou est demandé.
TBIF_IMAGE
Le membre iImage contient des informations valides ou est demandé.
TBIF_LPARAM
Le membre lParam contient des informations valides ou est demandé.
TBIF_SIZE
Le membre cx contient des informations valides ou est demandé.
TBIF_STATE
Le membre fsState contient des informations valides ou est demandé.
TBIF_STYLE
Le membre fsStyle contient des informations valides ou est demandé.
TBIF_TEXT
Le membre pszText contient des informations valides ou est demandé.

idCommand

Type : int

Identificateur de commande du bouton.

iImage

Type : int

Index d’image du 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 il 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, uniquement du texte.

fsState

Type : BYTE

Indicateurs d’état du bouton. Il peut s’agir d’une ou plusieurs des valeurs répertoriées dans états du bouton barre d’outils.

fsStyle

Type : BYTE

Indicateurs de style du bouton. Il peut s’agir d’une ou plusieurs des valeurs répertoriées dans contrôle de barre d’outils et styles de bouton.

cx

Type : WORD

Largeur du bouton, en pixels.

lParam

Type : DWORD_PTR

Valeur définie par l’application associée au bouton.

pszText

Type : LPTSTR

Adresse d’une mémoire tampon de caractères qui contient ou reçoit le texte du bouton.

cchText

Type : int

Taille de la mémoire tampon à pszText. Si les informations du bouton sont définies, ce membre est ignoré.

Remarques

Note

L’en-tête commctrl.h définit TBBUTTONINFO 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