TreeView_GetItem巨集 （commctrl.h）

擷取樹視圖專案的某些或所有屬性。 您可以使用此巨集或明確傳送 TVM_GETITEM 訊息。

語法

BOOL TreeView_GetItem(
   HWND     hwnd,
   LPTVITEM pitem
);

參數

hwnd

類型：HWND

樹視圖控件的句柄。

pitem

類型：LPTVITEM

TVITEM 結構的指標，指定要擷取和接收專案相關信息的資訊。 透過 4.71 版 和更新版本，您可以改用 TVITEMEX 結構。

傳回值

類型：BOOL

如果成功，則傳回 true true，否則會 傳回 false。

言論

傳送 TVM_GETITEM 訊息時，hItem 成員 TVITEM 或 TVITEMEX 結構會識別要擷取之資訊的專案，而 遮罩 成員會指定要擷取的屬性。

如果TVIF_TEXT旗標是在 TVITEM 或 TVITEMEX 結構的 遮罩 成員中設定，pszText 成員必須指向有效的緩衝區，而且 cchTextMax 成員必須設定為該緩衝區中的字元數。 傳回的文字不一定儲存在應用程式傳遞的原始緩衝區中。 pszText 可能會指向新緩衝區中的文字，而不是將它放在舊的緩衝區中。

要求

要求	價值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
支援的最低伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平臺	窗戶
標頭	commctrl.h