HDM_GETITEM Nachricht

Ruft Informationen zu einem Element in einem Headersteuerelement ab. Sie können diese Nachricht explizit senden oder das makro Header_GetItem verwenden.

Parameter

wParam

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

lParam

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

Gibt TRUE zurück, wenn der Vorgang erfolgreich war, oder andernfalls FALSE .

Bemerkungen

Wenn das HDI_TEXT-Flag im Maskenelement der HDITEM-Struktur festgelegt ist, kann das Steuerelement das pszText-Element 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.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Server 2003 [nur Desktop-Apps]
Header
Commctrl.h
Unicode- und ANSI-Name
HDM_GETITEMW (Unicode) und HDM_GETITEMA (ANSI)