messaggio LVM_SETITEM

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

Parametri

wParam

Deve essere zero.

lParam

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 mask 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 mask specifica il valore LVIF_STATE, il membro stateMask specifica gli stati dell'elemento da modificare e il membro dello stato contiene i valori per tali stati.

Valore restituito

Restituisce TRUE se l'operazione riesce o FALSE in caso contrario.

Commenti

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 impostare lo stato, pszText, iImage e lParam membri della struttura LVITEM .

Per impostare il testo di un elemento secondario, impostare i membri iItem e iSubItem per indicare l'elemento secondario specifico e usare 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 i membri lParam 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.

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_SETITEMW (Unicode) e LVM_SETITEMA (ANSI)