Header_GetItem Makro (commctrl.h)

Artikel
10/24/2024

Ruft Informationen zu einem Element in einem Kopfzeilensteuerelement ab. Sie können dieses Makro verwenden oder die HDM_GETITEM Nachricht explizit senden.

Syntax

BOOL Header_GetItem(
   HWND     hwndHD,
   int      i,
   LPHDITEM phdi
);

Parameter

hwndHD

Typ: HWND-

Ein Handle für das Kopfzeilensteuerelement.

i

Typ: int

Der Index des Elements, für das Informationen abgerufen werden sollen.

phdi

Typ: LPHDITEM-

Ein Zeiger auf eine HDITEM--Struktur. Wenn die Nachricht gesendet wird, gibt das Mask Element den Typ der angeforderten Informationen an. Wenn die Nachricht zurückgegeben wird, erhalten die anderen Mitglieder die angeforderten Informationen. Wenn das Mask Element 0 angibt, gibt die Nachricht TRUE zurück, kopiert jedoch keine Informationen in die Struktur.

Rückgabewert

Typ: BOOL-

Gibt TRUE zurück, wenn dies erfolgreich ist, oder FALSE andernfalls.

Bemerkungen

Wenn das HDI_TEXT Flag im Mask Element der HDITEM--Struktur festgelegt ist, kann das Steuerelement das pszText Element der Struktur ändern, um auf den neuen Text zu zeigen, anstatt den Puffer mit dem angeforderten Text zu füllen. Anwendungen sollten nicht davon ausgehen, dass der Text immer im angeforderten Puffer platziert wird.

Das Header_GetItem Makro ist wie folgt definiert:

#define Header_GetItem(hwndHD, i, phdi)      \

    (BOOL)SendMessage((hwndHD), HDM_GETITEM,   \

    (WPARAM)(int)(i), (LPARAM)(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