TreeView_GetItem Makro (commctrl.h)

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

Syntax

void TreeView_GetItem(
   hwnd,
   pitem
);

Parameter

hwnd

Typ: HWND

Handle für das Strukturansichtssteuerelement.

pitem

Typ: LPTVITEM

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

Rückgabewert

Keine

Bemerkungen

Wenn die TVM_GETITEM Nachricht gesendet wird, identifiziert das hItem-Element der TVITEM- oder TVITEMEX-Struktur das Element, zu dem Informationen abgerufen werden sollen, und das Maskenelement gibt die abzurufenden Attribute an.

Wenn das flag TVIF_TEXT im Maskenelement der TVITEM- oder TVITEMEX-Struktur festgelegt ist, muss das pszText-Element auf einen gültigen Puffer zeigen, und das cchTextMax-Element 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 ihn im alten Puffer zu platzieren.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile commctrl.h