樹狀檢視控制項 (MSAA UI 元素參考)

注意

本主題描述 MSAA UI 元素參考的 樹狀檢視控制項 物件。 此處未說明如何在各種 UI 架構中建立 樹狀檢視控制項 物件。 如需您使用的 UI 架構,請參閱 API 參考檔。

樹狀檢視控制項會使用線條來連接階層中的相關專案,顯示專案的階層式清單。 每個專案都包含標籤和選擇性點陣圖。 Windows 檔案總管會使用樹狀檢視控制項來顯示目錄。

樹狀檢視控制項的視窗類別名稱是WC_TREEVIEW,其定義為 Commctrl.h 中的 「SysTreeView」。

IAccessible 方法

樹狀檢視控制項支援下列 IAccessible 方法:

方法 註解
accDoDefaultAction 樹狀檢視物件本身沒有 accDoDefaultAction 方法。 根據樹狀檢視中專案的 State 屬性, accDoDefaultAction 會展開或折迭指定的專案。
accHitTest
accLocation
accNavigate
accSelect

IAccessible 屬性

樹狀檢視控制項支援下列 IAccessible 屬性:

屬性 註解
get_accChild
get_accChildCount 樹狀檢視物件的 ChildCount 屬性是樹狀檢視中包含的專案數目。 每個樹狀檢視專案的 ChildCount 屬性為零。
get_accDefaultAction 樹狀檢視物件本身沒有 DefaultAction 屬性。 展開樹狀檢視中的專案具有 「Collapse」 做為其 DefaultAction 屬性,而未展開的專案則具有 「Expand」 做為其 DefaultAction 屬性。
get_accDescription
get_accFocus
get_accHelp
get_accHelpTopic
get_accKeyboardShortcut
get_accName 樹狀檢視物件的Name屬性是從控制項的視窗文字 (或標題) 取得。 此文字不會與樹狀檢視控制項一起顯示,因此伺服器開發人員必須在控制項的資源定義語句中提供有意義的文字,以協助用戶端公用程式的使用者識別控制項。 樹狀檢視中專案的 Name 屬性是樹狀檢視專案中顯示的文字。
get_accParent 樹狀檢視物件的 Parent 屬性是視窗 ( ROLE_SYSTEM_WINDOW) 括住控制項,且具有與控制項相同的 Name 屬性和視窗類別名稱。 樹狀檢視中每個專案的 Parent 屬性是樹狀檢視物件。
get_accRole 樹狀檢視物件具有 Role 屬性 ROLE_SYSTEM_OUTLINE。 樹狀檢視中的每個專案都有 Role 屬性 ROLE_SYSTEM_OUTLINEITEM
get_accSelection
get_accState 樹狀檢視的State屬性是下列一或多個的組合:STATE_SYSTEM_INVISIBLE STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE |
針對樹狀檢視專案, State 屬性會包含 STATE_SYSTEM_EXPANDEDSTATE_SYSTEM_COLLAPSED
State屬性的其他可能值包括:
STATE_SYSTEM_FOCUSED | | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTEDSTATE_SYSTEM_HOTTRACKED
get_accValue 樹狀檢視物件沒有值。 每個樹狀檢視專案的 Value 屬性都是階層中專案的縮排層級。 例如,在 Windows 檔案總管中,專案 「Desktop」 的 Value 屬性為 「0」;位於階層中下一層的專案 「My Computer」,其 Value 屬性為 「1」;和階層中下一個層級的每個磁片磁碟機都有值為 「2」 的 Value 屬性。

備註

樹狀檢視專案的 accLocation 屬性只會傳回專案中文字的位置。 accLocation針對樹狀檢視專案所傳回的座標不包含位於文字左邊的圖示。

IAccessible 介面