Partager via

Structure NMTBDISPINFOA (commctrl.h)

  • Article

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 quels membres de cette structure 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
 Non implémenté actuellement.
TBNF_DI_SETITEM
 Définissez cet indicateur lors du traitement TBN_GETDISPINFO; le contrôle de barre d’outils conserve les informations fournies et ne le 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

Note

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