macro ListView_InsertItem (commctrl.h)

Inserisce un nuovo elemento in un controllo di visualizzazione elenco. È possibile usare questa macro o inviare in modo esplicito il messaggio LVM_INSERTITEM .

Sintassi

void ListView_InsertItem(
   hwnd,
   pitem
);

Parametri

hwnd

Tipo: HWND

Handle per il controllo di visualizzazione elenco.

pitem

Tipo: const LPLVITEM

Puntatore a una struttura LVITEM che specifica gli attributi dell'elemento di visualizzazione elenco. Usare il membro iItem per specificare l'indice in base zero in corrispondenza del quale deve essere inserito il nuovo elemento. Se questo valore è maggiore del numero di elementi attualmente contenuti dal controllo listview, il nuovo elemento verrà aggiunto alla fine dell'elenco e assegnato l'indice corretto. Esaminare il valore restituito della macro per determinare l'indice effettivo assegnato all'elemento.

Valore restituito

nessuno

Osservazioni

Non è possibile usare ListView_InsertItem o LVM_INSERTITEM per inserire elementi secondari. Il membro iSubItem della struttura LVITEM deve essere zero. Per informazioni sull'impostazione di elementi secondari, vedere LVM_SETITEM .

Se un controllo di visualizzazione elenco ha il set di stile LVS_EX_CHECKBOXES , qualsiasi valore inserito in bit da 12 a 15 del membro dello stato della struttura LVITEM verrà ignorato. Quando viene aggiunto un elemento con questo set di stili, verrà sempre impostato sullo stato deselezionato.

Se un controllo visualizzazione elenco ha lo stile della finestra LVS_SORTASCENDING o LVS_SORTDESCENDING, un messaggio di LVM_INSERTITEM avrà esito negativo se si tenta di inserire un elemento con LPSTR_TEXTCALLBACK come membro pszText della struttura LVITEM.

La macro ListView_InsertItem inserisce il nuovo elemento nella posizione appropriata nell'ordine di ordinamento se le condizioni seguenti contengono:

• Si usa uno degli stili di LVS_SORTXXX.
• Non si usa lo stile LVS_OWNERDRAW.
• Il membro pszText della struttura a cui punta da pitem non è impostato su LPSTR_TEXTCALLBACK.

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