macro ListView_SetItem (commctrl.h)

Imposta alcuni o tutti gli attributi di un elemento della visualizzazione elenco. È anche possibile usare ListView_SetItem per impostare il testo di un elemento secondario. È possibile utilizzare questa macro o inviare il messaggio di LVM_SETITEM in modo esplicito.

Sintassi

BOOL ListView_SetItem(
         HWND     hwnd,
   const LPLVITEM pitem
);

Parametri

hwnd

Tipo: HWND

Handle per il controllo visualizzazione elenco.

pitem

Tipo: const LPLVITEM

Puntatore a una struttura LVITEM che contiene i nuovi attributi dell'elemento. I membri iItem e iSubItem identificano l'elemento o l'elemento secondario e il membro maschera specifica gli attributi da impostare. Se il membro mask specifica il valore LVIF_TEXT, il membro pszText è l'indirizzo di una stringa con terminazione Null e il membro cchTextMax viene ignorato. Se il membro maschera specifica il valore LVIF_STATE, il membro stateMask specifica gli stati dell'elemento da modificare e lo stato membro contiene i valori per tali stati.

Valore restituito

Tipo: BOOL

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

Osservazioni

Per impostare gli attributi di un elemento della visualizzazione elenco, impostare il membro iItem della struttura LVITEM sull'indice dell'elemento e impostare il membro iSubItem su zero. Per un elemento, è possibile usare lo stato , pszText, iImagee lParam membri della struttura LVITEM per modificare questi parametri di elemento.

Per impostare il testo di un elemento secondario, impostare il iItem e iSubItem membri per indicare l'elemento secondario specifico e utilizzare il membro pszText per specificare il testo. In alternativa, è possibile utilizzare la macro ListView_SetItemText per impostare il testo di un elemento secondario. Non è possibile impostare lo stato o lParam membri per gli elementi secondari perché gli elementi secondari non dispongono di questi attributi. Nella versione 4.70 e successive è possibile impostare il membro iImage per gli elementi secondari. L'immagine dell'elemento secondario verrà visualizzata se il controllo visualizzazione elenco ha lo stile esteso LVS_EX_SUBITEMIMAGES. Le versioni precedenti ignoreranno l'immagine dell'elemento secondario.

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