清單方塊 (MSAA UI 元素參考)

注意

本主題描述 MSAA UI 元素參考用途的清單 物件。 此處未說明如何在各種 UI 架構中建立 清單方塊 物件。 如需您使用的 UI 架構,請參閱 API 參考檔。

清單方塊會顯示使用者可以從中選取一或多個專案的清單。 使用垂直捲動條、水準控制列或兩者建立清單方塊。

清單方塊的視窗類別名稱是 「LISTBOX」。

IAccessible 方法

清單方塊支援下列 IAccessible 方法:

方法 註解
accDoDefaultAction 清單方塊物件本身沒有 DefaultAction 屬性;不過, accDoDefaultAction 按兩下清單方塊專案。
accHitTest 如果測試點在清單方塊中,但不在清單方塊中的專案上, accHitTest 方法會傳回零。 如果測試點位於清單方塊中的專案上, accHitTest 會傳回清單方塊專案的索引。
accLocation
accNavigate
accSelect

IAccessible 屬性

清單方塊支援下列 IAccessible 屬性:

屬性 註解
get_accChild ChildCount屬性是清單方塊中的專案數。
get_accDefaultAction 清單方塊物件本身沒有 DefaultAction 屬性;不過,每個清單專案的 DefaultAction 屬性都是「按兩下」。
get_accDescription
get_accFocus
get_accHelp
get_accHelpTopic
get_accKeyboardShortcut KeyboardShortcut屬性是清單方塊存取鍵,這是與清單方塊相關聯之標籤文字中的加底線字元。 傳回的字串包含附加至字串 「Alt+」 的存取索引鍵字元。
get_accName 清單方塊物件的 Name 屬性是標示清單方塊之靜態文字控制項中的文字。 對於清單方塊專案, Name 屬性是清單專案的文字。
get_accParent Parent屬性是視窗 ( ROLE_SYSTEM_WINDOW) 括在清單方塊內,且具有與清單方塊相同的Name屬性和視窗類別名稱。 清單方塊專案的 Parent 屬性是清單方塊物件。
get_accRole Role屬性ROLE_SYSTEM_LIST。 清單方塊中的專案具有ROLE_SYSTEM_LISTITEM的 Role屬性。
get_accSelection Selection屬性會擷取清單方塊中選取的專案。
get_accState 清單方塊物件的State屬性是下列一或多個的組合:STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE STATE_SYSTEM_FOCUSED | | STATE_SYSTEM_FOCUSABLESTATE_SYSTEM_OFFSCREEN |
清單方塊專案的 State 屬性是下列一或多個值的組合:
| STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_MULTISELECTABLE | STATE_SYSTEM_SELECTED | STATE_SYSTEM_OFFSCREENSTATE_SYSTEM_NORMAL

IAccessible 介面

下拉式方塊

Scroll Bar