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
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 |
---|---|
|
Version 5.80. Le wParam envoyé avec un message TB_GETBUTTONINFO ou TB_SETBUTTONINFO est un index, et non un identificateur. |
|
Le membre idCommand contient des informations valides ou est demandé. |
|
Le membre iImage contient des informations valides ou est demandé. |
|
Le membre lParam contient des informations valides ou est demandé. |
|
Le membre cx contient des informations valides ou est demandé. |
|
Le membre fsState contient des informations valides ou est demandé. |
|
Le membre fsStyle contient des informations valides ou est demandé. |
|
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
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
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 |