Struttura NMHDDISPINFOW (commctrl.h)

Contiene informazioni utilizzate per la gestione dei codici di notifica HDN_GETDISPINFO.

Sintassi

typedef struct tagNMHDDISPINFOW {
  NMHDR  hdr;
  int    iItem;
  UINT   mask;
  LPWSTR pszText;
  int    cchTextMax;
  int    iImage;
  LPARAM lParam;
} NMHDDISPINFOW, *LPNMHDDISPINFOW;

Membri

hdr

Tipo: NMHDR

struttura di NMHDR contenente informazioni su questo codice di notifica.

iItem

Tipo: int

Indice in base zero dell'elemento nel controllo intestazione.

mask

Tipo: UINT

Set di flag di bit che specificano quali membri della struttura devono essere compilati dal proprietario del controllo intestazione. Questo valore può essere una combinazione dei valori seguenti:

Valore	Significato
HDI_TEXT	Il campo pszText deve essere compilato.
HDI_IMAGE	versione 4.70. Il campo iImage deve essere compilato.
HDI_LPARAM	Il campo lParam deve essere compilato.
HDI_DI_SETITEM	versione 4.70. Valore restituito. Indica che il controllo intestazione deve archiviare le informazioni sull'elemento e non richiederlo di nuovo.

pszText

Tipo: LPTSTR

Puntatore a una stringa con terminazione Null contenente il testo che verrà visualizzato per l'elemento di intestazione.

cchTextMax

Tipo: int

Dimensione del buffer a cui punta pszText.

iImage

Tipo: int

Indice in base zero di un'immagine all'interno dell'elenco di immagini. L'immagine specificata verrà visualizzata con l'elemento di intestazione, ma non assume il posto della bitmap dell'elemento. Se iImage è impostato su I_IMAGECALLBACK, il controllo richiede informazioni sull'immagine per questo elemento usando un codice di notifica HDN_GETDISPINFO.

lParam

Tipo: LPARAM

Valore definito dall'applicazione da associare all'elemento.

Osservazioni

Nota

L'intestazione commctrl.h definisce NMHDDISPINFO 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