下拉式方塊 (MSAA UI 元素參考)
注意
本主題描述 MSAA UI 元素參考的 下拉式方 塊物件。 此處未說明如何在各種 UI 架構中建立 下拉式方 塊物件。 如需您使用的 UI 架構,請參閱 API 參考檔。
下拉式方塊是與靜態控制項結合的清單方塊,或是在下拉式方塊的清單方塊部分中顯示目前選取項目的編輯控制項。 當使用者選取下拉式箭號 (,這是控制項旁的按鈕) 按鈕時,控制項的清單方塊部分會隨時顯示或只顯示下拉式清單。 如果選取範圍欄位是編輯控制項,使用者可以輸入不在清單中的資訊;否則,使用者只能選取清單中的專案。
下拉式方塊的視窗類別名稱是 「COMBOBOX」。
IAccessible屬性的內容取決於用戶端會查詢下拉式方塊的下列哪一部分:
- 下拉式方塊視窗
- 編輯控制項或靜態文字控制項
- 下拉式箭號 (,這是按鈕)
- 清單方塊
- 清單方塊中的清單專案
下拉式方塊支援下列 IAccessible 方法:
下拉式方塊支援下列 IAccessible 屬性:
get_accChildCount—下表顯示下拉式方塊不同部分的子計數值。
下拉式方塊元件 ChildCount 下拉式方塊視窗 3 編輯控制項 0 下拉式箭號 0 清單方塊 清單專案的數目 清單項目 0 get_accDefaultAction-下表顯示下拉式方塊不同部分的 DefaultAction 屬性。
下拉式方塊元件 DefaultAction 下拉式方塊視窗 無 編輯控制項 無 下拉式箭號 視下拉式清單的狀態而定,「Open」 或 「Close」 清單方塊 無 清單項目 「按兩下」 get_accKeyboardShortcut- 下表顯示下拉式方塊不同部分的 KeyboardShortcut 屬性。
下拉式方塊元件 KeyboardShortcut 下拉式方塊視窗 相關聯標籤的存取索引鍵 編輯控制項 無 下拉式箭號 「Alt+向下箭號」 清單方塊 無 清單項目 無 下拉式方塊的存取鍵是標示下拉式方塊之相關聯靜態文字控制項中的加底線字元。 例如,在開啟檔案的標準 [開啟] 對話方塊中,例如在 Microsoft WordPad 中,標示為 「Files of type:」 的下拉式方塊具有 KeyboardShortcut 「Alt+t」。
get_accName— 下表顯示下拉式方塊不同部分的 Name 屬性。
下拉式方塊元件 名稱 下拉式方塊視窗 作為標籤使用的靜態文字控制項 編輯控制項 作為標籤使用的靜態文字控制項 下拉式箭號 視下拉式清單的狀態而定,「Open」 或 「Close」 清單方塊 相關聯的標籤 清單項目 清單專案的文字 下拉式方塊的 Name 屬性、其子編輯控制項及其子清單方塊是標籤下拉式方塊之相關聯靜態文字控制項的文字。 例如,在開啟檔案的標準 [開啟] 對話方塊上,例如在 WordPad 中,這兩個下拉式方塊的 [名稱 ] 屬性為 「Look in:」 和 「Files of type:」。
get_accParent— 下表顯示下拉式方塊不同部分的父值。
下拉式方塊元件 Parent 下拉式方塊視窗 具有ROLE_SYSTEM_WINDOW Role屬性的視窗 ,其圍繞下拉式方塊,且具有與下拉式方塊相同的 Name 屬性和視窗類別名稱。 編輯控制項 (或靜態文字控制項) 下拉式方塊視窗。 下拉式箭號 下拉式方塊視窗。 清單方塊父視窗 下拉式方塊視窗。 此視窗會圍繞清單方塊。 清單方塊 清單方塊父視窗。 清單項目 清單方塊。 get_accRole- 下表顯示下拉式方塊不同部分的 Role 屬性。
下拉式方塊元件 角色 下拉式方塊視窗 ROLE_SYSTEM_COMBOBOX 編輯控制項 (或靜態文字控制項) ROLE_SYSTEM_TEXT 或 ROLE_SYSTEM_STATICTEXT 下拉式箭號 ROLE_SYSTEM_PUSHBUTTON 清單方塊 ROLE_SYSTEM_LIST 清單項目 ROLE_SYSTEM_LISTITEM get_accState- 下表顯示下拉式方塊不同部分的 State 屬性。
下拉式方塊元件 可能的狀態 下拉式方塊視窗 | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_NORMAL | STATE_SYSTEM_EXPANDEDSTATE_SYSTEM_COLLAPSED 編輯控制項 | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLESTATE_SYSTEM_NORMAL 下拉式箭號 0,這表示按鈕是可見且未按下的;或STATE_SYSTEM_PRESSED | STATE_SYSTEM_INVISIBLE |STATE_SYSTEM_NORMAL 清單方塊 | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_FLOATINGSTATE_SYSTEM_NORMAL 清單項目 | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTEDSTATE_SYSTEM_NORMAL get_accValue- 下表顯示下拉式方塊不同部分的 Value 屬性。
下拉式方塊元件 值 下拉式方塊視窗 目前選取清單專案的文字 編輯控制項 目前選取清單專案的文字 下拉式箭號 無 清單方塊 無 清單項目 無
- 使用下拉式方塊清單方塊部分的NAVDIR_NEXT旗標呼叫accNavigate時,它會在應該傳回VT_EMPTY時,不正確地流覽至匣視窗。