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

void ListView_SetItem(
   hwnd,
   pitem
);

Parametri

hwnd

Tipo: HWND

Handle per il controllo visualizzazione elenco.

pitem

Tipo: const LPLVITEM

Puntatore a una struttura LVITEM contenente gli attributi del nuovo 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

nessuno

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 i membri state, pszText, iImage e lParam della struttura LVITEM per modificare questi parametri di elemento.

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]
Piattaforma di destinazione	Windows
Intestazione	commctrl.h