Struttura NMTBDISPINFOW (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;
  LPWSTR    pszText;
  int       cchText;
} NMTBDISPINFOW, *LPNMTBDISPINFOW;

Membri

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	Attualmente non implementato.
TBNF_DI_SETITEM	Impostare questo flag durante l'elaborazione TBN_GETDISPINFO; il controllo barra degli strumenti manterrà le informazioni fornite e non la richiederà di nuovo.

idCommand

Tipo: int

Identificatore di comando dell'elemento per il quale 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 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 di pszText, in caratteri.

Osservazioni

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
intestazione	commctrl.h