macro ListView_GetItem (commctrl.h)

Ottiene alcuni o tutti gli attributi di un elemento della visualizzazione elenco. È possibile utilizzare questa macro o inviare il messaggio di LVM_GETITEM in modo esplicito.

Sintassi

BOOL ListView_GetItem(
   HWND     hwnd,
   LPLVITEM pitem
);

Parametri

hwnd

Tipo: HWND

Handle per il controllo visualizzazione elenco.

pitem

Tipo: LPLVITEM

Puntatore a una struttura LVITEM che specifica le informazioni da recuperare e ricevere informazioni sull'elemento della visualizzazione elenco.

Valore restituito

Tipo: BOOL

Restituisce TRUE in caso di esito positivo oppure FALSE in caso contrario.

Osservazioni

Quando viene inviato il messaggio di LVM_GETITEM, il iItem e iSubItem membri identificano l'elemento o l'elemento secondario per recuperare informazioni e il membro maschera specifica gli attributi da recuperare. Per un elenco dei valori possibili, vedere la descrizione della struttura LVITEM.

Se il flag di LVIF_TEXT viene impostato nel membro maschera della struttura LVITEM , il membro pszText deve puntare a un buffer valido e il membro cchTextMax deve essere impostato sul numero di caratteri in tale buffer. Le applicazioni non devono presupporre che il testo venga necessariamente inserito nel buffer specificato. Il controllo può invece modificare il membro pszText della struttura in modo che punti al nuovo testo anziché inserirlo nel buffer.

Se il membro maschera specifica il valore LVIF_STATE, il membro stateMask deve specificare i bit di stato dell'elemento da recuperare. Nell'output, lo stato membro contiene i valori dei bit di stato specificati.

Fabbisogno

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