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 |