分隔符號控制項類型

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

分隔符號控制項是用來以視覺方式將空間分隔成兩個區域。例如，分隔符號控制項可以是定義視窗中兩個窗格的分隔線。如果分隔符號是可移動的，控制項就應公開為控制項類型 Thumb。

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

本主題包含下列各節。

一般樹狀結構

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

控制項檢視	內容檢視
Separator	分隔符號控制項類型永遠不會有內容。

下表列出的 UI 自動化屬性，其值或定義與分隔符號控制項特別有關。如需消費者介面自動化屬性的詳細資訊，請參閱從消費者介面自動化 Elements 擷取屬性。

使用者介面自動化屬性	值	注意
UIA_AutomationIdPropertyId	請參閱備註。	此屬性的值在消費者介面自動化樹狀結構的原始檢視中的所有對等專案之間必須是唯一的。
UIA_BoundingRectanglePropertyId	請參閱備註。	包含整個控制項的最外層矩形。
UIA_ClickablePointPropertyId	請參閱備註。	如果有週框即受支援。如果周框內的每個點都不可點選，而且元素會執行特製化點擊測試，請覆寫並提供可點選的點。
UIA_ControlTypePropertyId	Separator
UIA_IsContentElementPropertyId	FALSE	分隔符號控制項絕不會是內容。
UIA_IsControlElementPropertyId	true	分隔符號控制項必須一律是控制項。
UIA_IsKeyboardFocusablePropertyId	請參閱備註。	如果控制項可接收鍵盤焦點，就必定支援此屬性。
UIA_LabeledByPropertyId	NULL	分隔符號控制項沒有靜態標籤。
UIA_LocalizedControlTypePropertyId	請參閱備註。	對應至分隔符號控制項類型的當地語系化字串。 en-US 或英文 (美國) 的預設值為「Separator」。
UIA_NamePropertyId	""	分隔符號控制項不需要 Name 屬性。

分隔符號控制項不必支援任何控制項模式。如需控制項模式的詳細資訊，請參閱 UI Automation Control Patterns Overview。

下表列出分隔符號控制項支援所需的消費者介面自動化事件。如需 UI Automation Events Overview事件的詳細資訊，請參閱

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