LVM_GETITEM messaggio

Recupera alcuni o tutti gli attributi dell'elemento di visualizzazione elenco. È possibile inviare questo messaggio in modo esplicito o usando la macro ListView_GetItem .

Parametri

wParam

Deve essere zero.

lParam

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

Valore restituito

Restituisce TRUE se ha esito positivo o FALSE in caso contrario.

Commenti

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 di 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 nel buffer. Le applicazioni non presuppongono che il testo venga necessariamente inserito nel buffer specificato. Il controllo può invece modificare il membro pszText della struttura in modo da puntare al nuovo testo, anziché posizionarlo nel buffer.

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

Requisiti

Requisito Valore
Client minimo supportato
Windows Vista [solo app desktop]
Server minimo supportato
Windows Server 2003 [solo app desktop]
Intestazione
Commctrl.h
Nomi Unicode e ANSI
LVM_GETITEMW (Unicode) e LVM_GETITEMA (ANSI)