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 |