ListView_InsertItem Makro (commctrl.h)

  • Artikel

Fügt ein neues Element in ein Listenansichtssteuerelement ein. Sie können dieses Makro verwenden oder die LVM_INSERTITEM Nachricht explizit senden.

Syntax

void ListView_InsertItem(
   hwnd,
   pitem
);

Parameter

hwnd

Typ: HWND

Ein Handle für das Listenansichtssteuerelement.

pitem

Typ: const LPLVITEM

Ein 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 im Listview-Steuerelement enthalten sind, wird das neue Element an das Ende der Liste angefügt und dem richtigen Index zugewiesen. Untersuchen Sie den Rückgabewert des Makros, um den tatsächlichen Index zu ermitteln, der dem Element zugewiesen ist.

Rückgabewert

Keine

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 Stilsatz 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 das LVS_SORTASCENDING - oder LVS_SORTDESCENDING Fensterformat aufweist, schlägt eine LVM_INSERTITEM Nachricht fehl, wenn Sie versuchen, ein Element einzufügen, das LPSTR_TEXTCALLBACK als pszText-Member seiner LVITEM-Struktur aufweist.

Das ListView_InsertItem Makro 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.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile commctrl.h