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 |