Struttura NMLVGETINFOTIPA (commctrl.h)

Contiene e riceve informazioni sull'elemento di 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;

Members

hdr

Tipo: NMHDR

Struttura 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 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 è mai consigliabile presupporre che questo buffer sia di una determinata dimensione, il valore INFOTIPSIZE può essere usato per scopi di progettazione.

iItem

Tipo: int

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

iSubItem

Tipo: int

Indice basato sull'elemento secondario a cui fa riferimento questa struttura. Se questo membro è zero, la struttura fa riferimento all'elemento e non a un elemento secondario. Questo membro non è attualmente usato e sarà sempre zero.

lParam

Tipo: LPARAM

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

Commenti

Si dice che un elemento venga 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

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