TreeView_SelectSetFirstVisible巨集 （commctrl.h）

垂直捲動樹檢視控件，以確保指定的項目可見。 可能的話，指定的專案會變成控件視窗頂端的第一個可見專案。 您可以使用此巨集或 TreeView_Select 巨集，或明確傳送 TVM_SELECTITEM 訊息。

語法

BOOL TreeView_SelectSetFirstVisible(
   HWND      hwnd,
   HTREEITEM hitem
);

參數

hwnd

類型：HWND

樹視圖控件的句柄。

hitem

類型：HTREEITEM

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

傳回值

類型：BOOL

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

言論

樹檢視控件會顯示視窗內符合的項目數目。 如果指定的專案靠近控件項目階層的底部，它可能不會成為第一個可見專案，視視窗內有多少專案而定。

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

使用 TreeView_SelectSetFirstVisible 巨集相當於將 TVM_SELECTITEM 訊息的 旗標傳送至TVGN_FIRSTVISIBLE值 參數。

要求