ComboBox 控制項類型

  • 發行項

本主題提供ComboBox控制項類型的 Microsoft 消費者介面自動化支援相關資訊。

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

下列各節會定義ComboBox控制項類型所需的消費者介面自動化樹狀結構、屬性、控制項模式和事件。 消費者介面自動化需求適用于 UI 架構/平臺整合消費者介面自動化控制項類型和控制項模式支援的所有下拉式方塊控制項。

本主題包含下列各節。

一般樹狀結構

下表描述與下拉式方塊控制項相關的消費者介面自動化樹狀結構的典型控制項和內容檢視，並描述每個檢視中可包含的內容。 如需 UI 自動化樹狀結構的詳細資訊，請參閱 UI 自動化樹狀結構概觀。

控制項檢視 內容檢視
  • ComboBox
    • 編輯 (0 或 1 個)
    • 列出 (0 或 1)
    • 清單項目 (子系清單；0 到多個)
    • 按鈕 (1)
  • ComboBox
    • 清單項目 (0 到多個)

 

只有在下拉式方塊可以編輯為接受任何輸入時，下拉式方塊中的下拉式方塊才需要下拉式方塊的編輯控制項，如同 [ 執行 ] 對話方塊中的下拉式方塊。

相關屬性

下表列出與ComboBox控制項類型特別相關的消費者介面自動化屬性。 如需消費者介面自動化屬性的詳細資訊，請參閱從 消費者介面自動化 Elements 擷取屬性。

使用者介面自動化屬性 值 注意
UIA_AutomationIdPropertyId 請參閱備註。 此屬性的值在消費者介面自動化樹狀結構的原始檢視中，所有對等專案都必須是唯一的。
UIA_BoundingRectanglePropertyId 請參閱備註。 包含整個控制項的最外層矩形。
UIA_ClickablePointPropertyId 請參閱備註。 如果有週框即受支援。 如果周框內的每個點都無法點選，且元素會執行特製化點擊測試，請覆寫並提供可點選的點。
UIA_ControlTypePropertyId ComboBox
UIA_HelpTextPropertyId 請參閱備註。 下拉式方塊控制項的解說文字應該說明為何要求使用者從下拉式方塊中選擇選項。 文字類似於透過工具提示呈現的資訊。 例如，「選取項目以設定顯示器的解析度。」
UIA_IsContentElementPropertyId true 此下拉式方塊控制項一律包含在 UI 自動化樹狀結構的內容檢視。
UIA_IsControlElementPropertyId true 此下拉式方塊控制項一律包含在 UI 自動化樹狀結構的控制項檢視。
UIA_IsKeyboardFocusablePropertyId true 下拉式方塊控制項可以接收鍵盤焦點;不過，當消費者介面自動化用戶端將焦點設定為下拉式方塊時，下拉式方塊子樹中的任何專案都可以接收焦點。
UIA_LabeledByPropertyId 請參閱備註。 下拉式方塊控制項通常會有此屬性參考的靜態文字標籤。
UIA_LocalizedControlTypePropertyId 請參閱備註。 對應至 ComboBox 控制項類型的當地語系化字串。 en-US 或英文 (美國) 的預設值為 「下拉式方塊」。
UIA_NamePropertyId 請參閱備註。 下拉式方塊控制項的名稱通常是從靜態文字標籤產生。 如果沒有靜態文字標籤，您必須為 Name 屬性指派值。 Name屬性絕不應包含下拉式方塊的目前內容，或在下拉式方塊的內容變更時變更。

 

必要的控制項模式

下表列出所有下拉式方塊控制項必須支援的 UI 自動化控制項模式。 如需控制項模式的詳細資訊，請參閱 UI Automation Control Patterns Overview。

控制項模式 支援 備註
IExpandCollapseProvider 必要 必須支援 ExpandCollapse 控制項模式，因為下拉式方塊控制項必須一律包含下拉式按鈕。
ISelectionProvider 相依 在下拉式方塊中顯示目前選取範圍。 [ 選取 範圍] 控制項模式的支援會委派給下拉式方塊下方的清單方塊，但可能不一定可行。
IValueProvider 相依 如果下拉式方塊可以接受任意文字值，則必須支援 [值 ] 控制項模式。 此模式可讓下拉式方塊的字串內容以程式設計方式設定。 如果不支援 [值] 控制項模式，使用者必須從下拉式方塊的子樹狀結構中選取清單專案。
IScrollProvider 永不 下拉式方塊上永遠不會直接支援 捲動 控制項模式。 如果下拉式方塊中包含的清單方塊可以捲動，而且只有在畫面上顯示清單方塊時，才支援它。

 

必要的事件

下表列出下拉式方塊控制項需要支援消費者介面自動化事件。 如需 UI Automation Events Overview事件的詳細資訊，請參閱

UI 自動化事件 備註
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId 屬性變更事件。
UIA_IsEnabledPropertyId 屬性變更事件。 如果控制項支援 IsEnabled 屬性，它必須支援這個事件。
UIA_IsOffscreenPropertyId 屬性變更事件。 如果控制項支援 IsOffscreen 屬性，它必須支援此事件。
UIA_StructureChangedEventId
UIA_ExpandCollapseExpandCollapseStatePropertyId 屬性變更事件。
UIA_ValueValuePropertyId 屬性變更事件。 如果控制項支援 Value 控制項模式，它必須支援這個事件。

 

概念

UI 自動化控制項類型概觀

UI 自動化概觀