共用方式為

TVM_SELECTITEM訊息

  • 發行項

選取指定的樹狀檢視專案、將專案捲動至檢視，或重新繪製樣式中的專案，以指出拖放作業的目標。 您可以使用 TreeView_Select、 TreeView_SelectItem或 宏TreeView_SelectDropTarget 來明確傳送此訊息。

參數

wParam

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

值 意義
TVGN_CARET
 將選取範圍設定為指定的專案。 樹狀檢視控制項的父視窗會接收 TVN_SELCHANGING 和 TVN_SELCHANGED 通知碼。
TVGN_DROPHILITE
 在樣式中重新繪製指定的專案，以指出拖放作業的目標。
TVGN_FIRSTVISIBLE
 確保指定的專案是可見的，如果可能的話，會顯示在控制項視窗頂端。 樹狀檢視控制項會顯示視窗內符合的專案數目。 如果指定的專案接近控制項專案階層的底部，它可能不會變成第一個可見專案，視視窗容納的專案數目而定。
TVSI_NOSINGLEEXPAND
 選取單一專案時，請確定樹狀檢視不會展開該專案的子系。 只有在與 TVGN_CARET 旗標搭配使用時才有效。
注意： 若要使用此旗標，您必須提供指定 Comclt32.dll 6.0 版的資訊清單。 如需資訊清單的詳細資訊，請參閱 啟用視覺樣式。

lParam

專案的控制碼。 如果 lParam 為 Null，控制項會設定為沒有選取的專案。

傳回值

如果成功，則傳回 TRUE ，否則傳回 FALSE 。

備註

如果指定的專案是折迭父專案的子專案，則會展開父項的子專案清單以顯示指定的專案。 在此情況下，控制項的父視窗會收到 TVN_ITEMEXPANDING 和 TVN_ITEMEXPANDED 通知碼。

使用TreeView_SelectItem宏相當於將wParam設定為TVGN_CARET 值的傳送TVM_SELECTITEM訊息。 使用TreeView_SelectDropTarget宏相當於將wParam設定為TVGN_DROPHILITE 值的傳送TVM_SELECTITEM訊息。 使用TreeView_SelectSetFirstVisible相當於將wParam設定為 TVGN_FIRSTVISIBLE 值的傳送TVM_SELECTITEM訊息。

規格需求

需求 值
最低支援的用戶端
 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器
 Windows Server 2003 [僅限傳統型應用程式]
標頭
Commctrl.h