TreeView_GetItem Makro (commctrl.h)

Artikel
10/24/2024

Ruft einige oder alle Attribute eines Strukturansichtselements ab. Sie können dieses Makro verwenden oder die TVM_GETITEM Nachricht explizit senden.

Syntax

BOOL TreeView_GetItem(
   HWND     hwnd,
   LPTVITEM pitem
);

Parameter

hwnd

Typ: HWND-

Behandeln sie das Strukturansichtssteuerelement.

pitem

Typ: LPTVITEM-

Zeiger auf eine TVITEM- Struktur, die die abzurufenden informationen angibt und Informationen über das Element empfängt. Mit Version 4.71 und höher können Sie stattdessen eine TVITEMEX- Struktur verwenden.

Rückgabewert

Typ: BOOL-

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

Bemerkungen

Wenn die TVM_GETITEM Nachricht gesendet wird, identifiziert das hItem-Element Mitglied des TVITEM- oder TVITEMEX- Struktur das Element, über das Informationen abgerufen werden sollen, und das Mask Element gibt die abzurufenden Attribute an.

Wenn das TVIF_TEXT Flag im Mask Member des TVITEM oder TVITEMEX Struktur festgelegt ist, muss das pszText Member auf einen gültigen Puffer zeigen, und das cchTextMax Member muss auf die Anzahl der Zeichen in diesem Puffer festgelegt werden. Der zurückgegebene Text wird nicht unbedingt im ursprünglichen Puffer gespeichert, der von der Anwendung übergeben wird. Es ist möglich, dass pszText- auf Text in einem neuen Puffer zeigt, anstatt sie im alten Puffer zu platzieren.

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