下拉式方塊 (MSAA UI 元素參考)

注意

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

 

下拉式方塊是與靜態控制項結合的清單方塊，或是在下拉式方塊的清單方塊部分中顯示目前選取項目的編輯控制項。 當使用者選取下拉式箭號 (，這是控制項旁的按鈕) 按鈕時，控制項的清單方塊部分會隨時顯示或只顯示下拉式清單。 如果選取範圍欄位是編輯控制項，使用者可以輸入不在清單中的資訊;否則，使用者只能選取清單中的專案。

下拉式方塊的視窗類別名稱是 「COMBOBOX」。

IAccessible屬性的內容取決於用戶端會查詢下拉式方塊的下列哪一部分：

• 下拉式方塊視窗
• 編輯控制項或靜態文字控制項
• 下拉式箭號 (，這是按鈕)
• 清單方塊
• 清單方塊中的清單專案

IAccessible 方法

下拉式方塊支援下列 IAccessible 方法：

• accDoDefaultAction
• accHitTest
• accLocation
• accNavigate
• accSelect

IAccessible 屬性

下拉式方塊支援下列 IAccessible 屬性：

• get_accChild

• get_accChildCount—下表顯示下拉式方塊不同部分的子計數值。

  下拉式方塊元件	ChildCount
  下拉式方塊視窗	3
  編輯控制項	0
  下拉式箭號	0
  清單方塊	清單專案的數目
  清單項目	0

   

• get_accDefaultAction-下表顯示下拉式方塊不同部分的 DefaultAction 屬性。

  下拉式方塊元件	DefaultAction
  下拉式方塊視窗	無
  編輯控制項	無
  下拉式箭號	視下拉式清單的狀態而定，「Open」 或 「Close」
  清單方塊	無
  清單項目	「按兩下」

   

• get_accDescription

• get_accFocus

• get_accHelp

• get_accHelpTopic

• 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時，不正確地流覽至匣視窗。

相關主題

IAccessible 介面