TreeView_GetItem宏 (commctrl.h)

擷取樹狀檢視專案的部分或所有屬性。 您可以使用此宏,或明確傳送 TVM_GETITEM 訊息。

語法

void TreeView_GetItem(
   hwnd,
   pitem
);

參數

hwnd

類型: HWND

樹狀檢視控制項的控制碼。

pitem

類型: LPTVITEM

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

傳回值

備註

傳送TVM_GETITEM訊息時,TVITEMTVITEMEX結構的hItem成員會識別要擷取相關資訊的專案,而遮罩成員會指定要擷取的屬性。

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

規格需求

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