messaggio LVM_INSERTITEM

Inserisce un nuovo elemento in un controllo di visualizzazione elenco. È possibile inviare questo messaggio in modo esplicito o usando la macro ListView_InsertItem .

Parametri

wParam

Deve essere zero.

lParam

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 dalla visualizzazione elenco, il nuovo elemento verrà aggiunto alla fine dell'elenco e assegnato l'indice corretto. Esaminare il valore restituito del messaggio per determinare l'indice effettivo assegnato all'elemento.

Valore restituito

Restituisce l'indice del nuovo elemento se ha esito positivo o -1 in caso contrario.

Commenti

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 stili 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_SORTASCENDINGo LVS_SORTDESCENDING, un messaggio di LVM_INSERTITEM avrà esito negativo se si tenta di inserire un elemento con LPSTR_TEXTCALLBACK come valore per il membro pszText .

Il messaggio di LVM_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.

Se la struttura LVITEM non contiene LVIF_GROUPID nel membro mask , il valore del membro iGroupId è I_GROUPIDCALLBACK per impostazione predefinita.

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_INSERTITEMW (Unicode) e LVM_INSERTITEMA (ANSI)