Struttura NMTBDISPINFOA (commctrl.h)

Contiene e riceve informazioni di visualizzazione per un elemento della barra degli strumenti. Questa struttura viene usata con il codice di notifica TBN_GETDISPINFO .

Sintassi

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

Members

hdr

Tipo: NMHDR

Struttura NMHDR che contiene informazioni aggiuntive sulla notifica.

dwMask

Tipo: DWORD

Set di flag che indicano quali membri di questa struttura vengono richiesti. Può trattarsi di uno o più dei valori seguenti.

Valore	Significato
TBNF_IMAGE	Viene richiesto l'indice dell'immagine dell'elemento. L'indice dell'immagine deve essere inserito nel membro iImage .
TBNF_TEXT	Non implementato attualmente.
TBNF_DI_SETITEM	Imposta questo flag durante l'elaborazione TBN_GETDISPINFO; il controllo della barra degli strumenti manterrà le informazioni fornite e non la richiederà di nuovo.

idCommand

Tipo: int

Identificatore del comando dell'elemento per cui vengono richieste informazioni di visualizzazione. Questo membro viene compilato dal controllo prima di inviare il codice di notifica.

lParam

Tipo: DWORD_PTR

Valore definito dall'applicazione associato all'elemento per il quale vengono richieste informazioni di visualizzazione. Questo membro viene compilato dal controllo prima di inviare il codice di notifica.

iImage

Tipo: int

Indice dell'immagine per l'elemento.

pszText

Tipo: LPTSTR

Puntatore a un buffer di caratteri che riceve il testo dell'elemento.

cchText

Tipo: int

Dimensioni del buffer pszText , in caratteri.

Commenti

Nota

L'intestazione commctrl.h definisce NMTBDISPINFO come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	commctrl.h