LVM_INSERTITEM Nachricht

Artikel
06/13/2023

Fügt ein neues Element in ein Listenansichtssteuerelement ein. Sie können diese Nachricht explizit oder mithilfe des makros ListView_InsertItem senden.

Parameter

wParam: Muss Null sein.
lParam: Zeiger auf eine LVITEM-Struktur , die die Attribute des Listenansichtselements angibt. Verwenden Sie das iItem-Element , um den nullbasierten Index anzugeben, an dem das neue Element eingefügt werden soll. Wenn dieser Wert größer ist als die Anzahl der Elemente, die derzeit in der Listenansicht enthalten sind, wird das neue Element an das Ende der Liste angefügt und dem richtigen Index zugewiesen. Untersuchen Sie den Rückgabewert der Nachricht, um den tatsächlichen Index zu ermitteln, der dem Element zugewiesen ist.

Rückgabewert

Gibt bei erfolgreicher Ausführung den Index des neuen Elements zurück, andernfalls -1.

Bemerkungen

Sie können ListView_InsertItem oder LVM_INSERTITEM nicht verwenden, um Unterelemente einzufügen. Das iSubItem-Element der LVITEM-Struktur muss 0 sein. Informationen zum Festlegen von Unterelementen finden Sie unter LVM_SETITEM .

Wenn für ein Listenansichtssteuerelement der LVS_EX_CHECKBOXES Stil festgelegt ist, werden alle Werte ignoriert, die in den Bits 12 bis 15 des Zustandselements der LVITEM-Struktur platziert werden. Wenn ein Element mit diesem Formatvorlagensatz hinzugefügt wird, wird es immer auf den deaktivierten Zustand festgelegt.

Wenn ein Listenansichtssteuerelement entweder die LVS_SORTASCENDING - oder LVS_SORTDESCENDING Fensterformat aufweist, schlägt eine LVM_INSERTITEM Meldung fehl, wenn Sie versuchen, ein Element einzufügen, das LPSTR_TEXTCALLBACK als Wert für sein pszText-Element enthält.

Die LVM_INSERTITEM Nachricht fügt das neue Element an der richtigen Position in der Sortierreihenfolge ein, wenn die folgenden Bedingungen gelten:

Sie verwenden einen der LVS_SORTXXX Stile.
Sie verwenden nicht den LVS_OWNERDRAW-Stil .
Das pszText-Element der Struktur, auf die pitem verweist, ist nicht auf LPSTR_TEXTCALLBACK festgelegt.

Wenn die LVITEM-Struktur keine LVIF_GROUPID im Maskenelement enthält, wird der Wert des iGroupId-Elements standardmäßig I_GROUPIDCALLBACK.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Commctrl.h
Unicode- und ANSI-Name	LVM_INSERTITEMW (Unicode) und LVM_INSERTITEMA (ANSI)

Freigeben über