共用方式為


TreeView_Select巨集 (commctrl.h)

選取指定的樹視圖專案、將專案捲動到檢視中,或重新繪製用來指出拖放作業目標的樣式中的專案。 您可以使用此巨集或 TreeView_SelectItemTreeView_SelectSetFirstVisibleTreeView_SelectDropTarget 巨集,或明確傳送 TVM_SELECTITEM 訊息。

語法

BOOL TreeView_Select(
   HWND      hwnd,
   HTREEITEM hitem,
   UINT      code
);

參數

hwnd

類型:HWND

樹視圖控件的句柄。

hitem

類型:HTREEITEM

專案的句柄。 如果 hitem 參數 NULL,則控件會設定為沒有選取的專案。

code

類型:UINT

動作旗標。 此參數可以是下列其中一個值:

價值 意義
TVGN_CARET
將選取範圍設定為指定的專案。 控件的父視窗會接收 TVN_SELCHANGINGTVN_SELCHANGED 通知碼。
TVGN_DROPHILITE
在樣式中重新繪製指定專案,以指出拖放作業的目標。
TVGN_FIRSTVISIBLE
確保指定的專案是可見的,如果可能的話,會顯示在控件視窗頂端。 樹檢視控件會顯示視窗內符合的項目數目。 如果指定的專案靠近控件項目階層的底部,它可能不會成為第一個可見專案,視視窗內有多少專案而定。

傳回值

類型:BOOL

如果成功,則傳回 true true,否則會 傳回 false

言論

如果指定的專案是折疊父專案的子專案,則會展開父項的子專案清單以顯示指定的專案。 在此情況下,父視窗會收到 TVN_ITEMEXPANDINGTVN_ITEMEXPANDED 通知碼。

要求

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