Header_GetItem Makro (commctrl.h)

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

Syntax

void Header_GetItem(
   hwndHD,
   i,
   phdi
);

Parameter

hwndHD

Typ: HWND

Ein Handle für das Headersteuerelement.

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 Maskenelement den Typ der angeforderten Informationen an. Wenn die Nachricht zurückgegeben wird, erhalten die anderen Mitglieder die angeforderten Informationen. Wenn das Maskenmember null angibt, gibt die Nachricht TRUE zurück, kopiert jedoch keine Informationen in die Struktur.

Rückgabewert

Keine

Bemerkungen

Wenn das HDI_TEXT-Flag im Maskenelement der HDITEM-Struktur festgelegt ist, kann das Steuerelement den pszText-Member der Struktur so ändern, dass es auf den neuen Text verweist, 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 makro Header_GetItem wird wie folgt definiert:

#define Header_GetItem(hwndHD, index, phdi)      \

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

    (WPARAM)(int)(index), (LPARAM)(LPHDITEM)(phdi))

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