清單檢視控制元件 (MSAA UI 元素參考)
注意
本主題描述 用於 MSAA UI 元素參考的 List-View 控件 物件。 此處未說明如何在各種UI架構中建立 List-View Control 物件。 如需您使用的 UI 架構,請參閱 API 參考檔。
清單檢視控件會顯示專案集合,每個專案都包含圖示和標籤,並提供數種方式來顯示及排列專案。 例如,每個專案的其他資訊會顯示在圖示和標籤右邊的數據行中。 Windows 檔案總管會使用清單檢視控件來顯示檔案。
清單檢視控件的視窗類別名稱是WC_LISTVIEW,其定義為 Commctrl.h 中的 “SysListView”。
清單檢視控制項支援下列 IAccessible 方法:
方法 | 註解 |
---|---|
accDoDefaultAction | list-view 物件本身沒有DefaultAction屬性;不過,accDoDefaultAction方法會按兩下清單檢視專案。 |
accHitTest | |
accLocation | |
accNavigate | |
accSelect |
清單檢視控制項支援下列 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。 |
- Microsoft Active Accessibility 不會公開應用程式中使用回呼函式將文字新增至專案的清單檢視項目文字。
- 已裁剪的清單檢視項目未設定STATE_SYSTEM_INVISIBLE。 若要判斷清單專案是否已裁剪,用戶端可以比較 accLocation 所傳回的專案座標與視窗的裁剪區域。
- Microsoft Active Accessibility 不支援使用 accNavigate 方法來巡覽至 [詳細數據] 檢視中列表檢視控件內的標頭控件。 不過,用戶端會使用 AccessibleObjectFromPoint 函式來取得標頭控件。
- 對於詳細數據檢視中列表檢視專案之類的非矩形物件,如果使用 accHitTest 測試,accHitTest 所擷取之專案的周框座標會失敗,因為 accHitTest 會以圖元為單位決定物件的界限。