Struttura NMLVGETINFOTIPA (commctrl.h)

Contiene e riceve informazioni sull'elemento della visualizzazione elenco necessarie per visualizzare una descrizione comando per un elemento. Questa struttura viene usata con il codice di notifica LVN_GETINFOTIP.

Sintassi

typedef struct tagNMLVGETINFOTIPA {
  NMHDR  hdr;
  DWORD  dwFlags;
  LPSTR  pszText;
  int    cchTextMax;
  int    iItem;
  int    iSubItem;
  LPARAM lParam;
} NMLVGETINFOTIPA, *LPNMLVGETINFOTIPA;

Membri

hdr

Tipo: NMHDR

struttura di NMHDR che contiene informazioni su questo codice di notifica.

dwFlags

Tipo: DWORD

Zero o LVGIT_UNFOLDED. Vedere la sezione Osservazioni.

pszText

Tipo: LPTSTR

Indirizzo di un buffer di stringa che riceve eventuali informazioni di testo aggiuntive. Se dwFlags è zero, questo membro conterrà il testo dell'elemento esistente. In questo caso, è necessario aggiungere qualsiasi testo aggiuntivo alla fine di questa stringa. Le dimensioni di questo buffer vengono specificate dalla struttura cchTextMax.

cchTextMax

Tipo: int

Dimensioni, in caratteri, del buffer a cui punta pszText. Anche se non si deve mai presupporre che questo buffer sia di una dimensione specifica, il valore INFOTIPSIZE può essere usato a scopo di progettazione.

iItem

Tipo: int

Indice in base zero dell'elemento a cui fa riferimento questa struttura.

iSubItem

Tipo: int

Indice in base uno dell'elemento secondario a cui fa riferimento questa struttura. Se questo membro è zero, la struttura fa riferimento all'elemento e non a un sottoelemento. Questo membro non è attualmente utilizzato e sarà sempre zero.

lParam

Tipo: LPARAM

Valore definito dall'applicazione associato all'elemento. Questo membro non è attualmente utilizzato e sarà sempre zero.

Osservazioni

Un elemento viene detto essere piegato quando il testo attualmente visualizzato viene troncato. Se LVGIT_UNFOLDED viene restituito in dwFlags, il testo completo dell'elemento è già visualizzato, quindi non è necessario visualizzarlo nella descrizione comando.

Nota

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