Structure NMTBDISPINFOA (commctrl.h)

Contient et reçoit des informations d’affichage pour un élément de barre d’outils. Cette structure est utilisée avec le code de notification TBN_GETDISPINFO .

Syntaxe

typedef struct {
  NMHDR     hdr;
  DWORD     dwMask;
  int       idCommand;
  DWORD_PTR lParam;
  int       iImage;
  LPSTR     pszText;
  int       cchText;
} NMTBDISPINFOA, *LPNMTBDISPINFOA;

Membres

hdr

Type : NMHDR

Structure NMHDR qui contient des informations supplémentaires sur la notification.

dwMask

Type : DWORD

Ensemble d’indicateurs qui indiquent les membres de cette structure qui sont demandés. Il peut s’agir d’une ou plusieurs des valeurs suivantes.

Valeur	Signification
TBNF_IMAGE	L’index d’image de l’élément est demandé. L’index d’image doit être placé dans le membre iImage .
TBNF_TEXT	Actuellement non implémenté.
TBNF_DI_SETITEM	Définissez cet indicateur lors du traitement des TBN_GETDISPINFO ; le contrôle de barre d’outils conserve les informations fournies et ne les demande pas à nouveau.

idCommand

Type : int

Identificateur de commande de l’élément pour lequel les informations d’affichage sont demandées. Ce membre est renseigné par le contrôle avant d’envoyer le code de notification.

lParam

Type : DWORD_PTR

Valeur définie par l’application associée à l’élément pour lequel les informations d’affichage sont demandées. Ce membre est renseigné par le contrôle avant d’envoyer le code de notification.

iImage

Type : int

Index d’image de l’élément.

pszText

Type : LPTSTR

Pointeur vers une mémoire tampon de caractères qui reçoit le texte de l’élément.

cchText

Type : int

Taille de la mémoire tampon pszText , en caractères.

Remarques

Notes

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

Configuration requise

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