Header_InsertItem Makro (commctrl.h)

2024-10-24

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

Syntax

int Header_InsertItem(
         HWND     hwndHD,
         int      i,
   const LPHDITEM phdi
);

Parameter

hwndHD

Typ: HWND-

Ein Handle für das Kopfzeilensteuerelement.

i

Typ: int

Der Index des Elements, nach dem das neue Element eingefügt werden soll. Das neue Element wird am Ende des Kopfzeilensteuerelements eingefügt, wenn i größer oder gleich der Anzahl der Elemente im Steuerelement ist. Wenn i null ist, wird das neue Element am Anfang des Kopfzeilensteuerelements eingefügt.

phdi

Typ: LPHDITEM-

Ein Zeiger auf eine HDITEM--Struktur, die Informationen zum neuen Element enthält.

Rückgabewert

Typ: int

Gibt den Index des neuen Elements zurück, wenn das Element erfolgreich verläuft oder andernfalls -1.

Bemerkungen

Das Header_InsertItem Makro ist wie folgt definiert:

#define Header_InsertItem(hwndHD, i, phdi) \

    (int)SendMessage((hwndHD), HDM_INSERTITEM, (WPARAM)(int)(i), \

    (LPARAM)(const LPHDITEM)(phdi))

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	commctrl.h

Freigeben über