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

void ListView_GetItem(
   hwnd,
   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

nessuno

Osservazioni

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

Se il flag LVIF_TEXT è impostato nel membro mask 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 mask specifica il valore LVIF_STATE, il membro stateMask deve specificare i bit dello stato dell'elemento da recuperare. Nell'output, il membro di stato contiene i valori dei bit di stato specificati.

Requisiti

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