樹檢視控件 (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 屬性。 展開的樹視圖中的專案會將其 DefaultAction 屬性作為「折疊」,而未展開的專案會將其 DefaultAction 屬性。 |
get_accDescription | |
get_accFocus | |
get_accHelp | |
get_accHelpTopic | |
get_accKeyboardShortcut | |
get_accName | 樹檢視物件的 Name 屬性是從控件的視窗文字 (或 caption) 取得。 此文字不會與樹視圖控件一起顯示,因此伺服器開發人員必須在控件的資源定義語句中提供有意義的文字,以協助用戶端公用程式的用戶識別控件。 樹檢視中專案 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_EXPANDED 或 STATE_SYSTEM_COLLAPSED。 State 屬性的其他可能值包括: STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTED | STATE_SYSTEM_HOTTRACKED |
get_accValue | 樹視圖對象沒有值。 每個樹檢視專案的 Value 屬性是階層中項目的縮排層級。 例如,在 Windows 檔案總管中,專案 「Desktop」 具有 「0」 Value 屬性;位於階層中下一層的專案 「My Computer」 具有 「1」 的 Value 屬性:和階層中下一個層級的每個磁碟驅動器都有 “2” Value 屬性。 |
筆記
樹視圖專案的 accLocation 屬性只會傳回專案中文字的位置。 樹視圖專案 accLocation 所傳回的座標不包含位於文字左邊的圖示。