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 |