閱讀英文

共用方式為


清單檢視控制元件 (MSAA UI 元素參考)

注意

本主題描述 用於 MSAA UI 元素參考的 List-View 控件 物件。 此處未說明如何在各種UI架構中建立 List-View Control 物件。 如需您使用的 UI 架構,請參閱 API 參考檔。

清單檢視控件會顯示專案集合,每個專案都包含圖示和標籤,並提供數種方式來顯示及排列專案。 例如,每個專案的其他資訊會顯示在圖示和標籤右邊的數據行中。 Windows 檔案總管會使用清單檢視控件來顯示檔案。

清單檢視控件的視窗類別名稱是WC_LISTVIEW,其定義為 Commctrl.h 中的 “SysListView”。

IAccessible 方法

清單檢視控制項支援下列 IAccessible 方法:

方法 註解
accDoDefaultAction list-view 物件本身沒有DefaultAction屬性;不過,accDoDefaultAction方法會按兩下清單檢視專案。
accHitTest
accLocation
accNavigate
accSelect

IAccessible 屬性

清單檢視控制項支援下列 IAccessible 屬性:

屬性 註解
get_accChild
get_accChildCount ChildCount 屬性是清單中的項目數。
get_accDefaultAction list-view 物件本身沒有 DefaultAction 屬性;不過, 每個清單檢視專案的 DefaultAction 屬性是 “Double Click”。
get_accDescription list-view 物件本身不支援 Description 屬性;不過,每個清單檢視專案的 Description 屬性是專案第二個和後續數據行中包含的文字。 在每個數據行的文字之間插入逗號。
get_accFocus
get_accHelp
get_accHelpTopic
get_accKeyboardShortcut 清單檢視對象沒有鍵盤快捷方式。 不過,如果清單檢視控件的視窗文字包含 ampersand (&) 字元,Microsoft Active Accessibility 會傳回非 Null 字串做為 KeyboardShortcut 屬性。
get_accName 清單檢視物件的 [名稱] 會從控件的視窗文字 (或 標題) 取得。 此文字不會與清單檢視控件一起顯示,因此伺服器開發人員必須在控件的資源定義語句中提供有意義的文字,以協助用戶端公用程式的用戶識別控件。 對於清單檢視專案, Name 屬性是清單專案的文字。
get_accParent list-view 物件的 Parent 是圍繞控件的視窗 (ROLE_SYSTEM_WINDOW),而且具有與控件相同的 Name 屬性和視窗類別名稱。 list-view 專案的 Parent 屬性是 list-view 物件。
get_accRole ROLE_SYSTEM_LIST的角色,而列表檢視控件中的每個專案都有 ROLE_SYSTEM_LISTITEM 的 Role 屬性。
get_accSelection
get_accState list-view 物件的 State 屬性是下列一或多個值的組合:STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE STATE_SYSTEM_FOCUSED STATE_SYSTEM_FOCUSABLE STATE_SYSTEM_OFFSCREEN | | |
清單檢視專案的 State 屬性是下列一或多個值的組合:
| | | | | | | STATE_SYSTEM_INVISIBLE STATE_SYSTEM_FOCUSED STATE_SYSTEM_FOCUSABLE STATE_SYSTEM_SELECTABLE STATE_SYSTEM_SELECTED STATE_SYSTEM_MULTISELECTABLE STATE_SYSTEM_HOTTRACKED STATE_SYSTEM_OFFSCREEN STATE_SYSTEM_NORMAL |
此外,複選框清單檢視專案也有狀態 STATE_SYSTEM_CHECKED

備註

IAccessible 介面