TreeView_Select巨集 (commctrl.h)
選取指定的樹視圖專案、將專案捲動到檢視中,或重新繪製用來指出拖放作業目標的樣式中的專案。 您可以使用此巨集或 TreeView_SelectItem、TreeView_SelectSetFirstVisible或 TreeView_SelectDropTarget 巨集,或明確傳送 TVM_SELECTITEM 訊息。
語法
BOOL TreeView_Select(
HWND hwnd,
HTREEITEM hitem,
UINT code
);
參數
hwnd
類型:HWND
樹視圖控件的句柄。
hitem
類型:HTREEITEM
專案的句柄。 如果 hitem 參數 NULL,則控件會設定為沒有選取的專案。
code
類型:UINT
動作旗標。 此參數可以是下列其中一個值:
價值 | 意義 |
---|---|
|
將選取範圍設定為指定的專案。 控件的父視窗會接收 TVN_SELCHANGING 和 TVN_SELCHANGED 通知碼。 |
|
在樣式中重新繪製指定專案,以指出拖放作業的目標。 |
|
確保指定的專案是可見的,如果可能的話,會顯示在控件視窗頂端。 樹檢視控件會顯示視窗內符合的項目數目。 如果指定的專案靠近控件項目階層的底部,它可能不會成為第一個可見專案,視視窗內有多少專案而定。 |
傳回值
類型:BOOL
如果成功,則傳回 true true,否則會 傳回 false。
言論
如果指定的專案是折疊父專案的子專案,則會展開父項的子專案清單以顯示指定的專案。 在此情況下,父視窗會收到 TVN_ITEMEXPANDING 和 TVN_ITEMEXPANDED 通知碼。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
支援的最低伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
目標平臺 | 窗戶 |
標頭 | commctrl.h |