共用方式為

ScrollBar 控件類型

  • 發行項

本主題提供 ScrollBar 控件類型的Microsoft UI 自動化支援相關信息。

滾動條控制件可讓使用者在視窗或專案容器內捲動內容。 控件是由一組按鈕和拇指控件所組成。

下列各節會定義 ScrollBar 控件類型所需的 UI 自動化樹狀結構、屬性、控件模式和事件。 使用者介面自動化需求適用於所有滾動條控件，其中 UI 架構/平臺會整合控件類型和控件模式的 UI 自動化支援。

本主題包含下列各節。

一般樹狀結構

下表描述與滾動條控件相關的UI自動化樹狀結構的一般控件和內容檢視，並描述每個檢視中可包含的內容。 如需 UI 自動化樹狀結構的詳細資訊，請參閱 UI 自動化樹狀結構概觀。

控件檢視 內容檢視
  • ScrollBar
    • 按鈕 （0、2 或 4）
    • 拇指 （0 或 1）
 不適用。 （滾動條控件沒有內容。

 

滾動條控件可以有零到五個子系。 因為子樹有多個按鈕控制件，因此元素必須為每個項目設定特定的 UIA_AutomationIdPropertyId 值，使其可供自動測試工具探索。

相關屬性

下表列出UI自動化屬性，其值或定義與滾動條控件特別相關。 請注意，滾動條控件永遠不會有內容;其功能會透過卷動 卷動 控件模式來公開，而此模式在捲動的容器上則受到支援。

如需 UI 自動化屬性的詳細資訊，請參閱 從 UI 自動化元素擷取屬性。

UI 自動化屬性 價值 筆記
UIA_AutomationIdPropertyId 請參閱附注。 在UI自動化樹狀結構的原始檢視中，此屬性的值在所有對等專案之間必須是唯一的。
UIA_BoundingRectanglePropertyId 請參閱附注。 包含整個控件的最外框。
UIA_ClickablePointPropertyId 南 滾動條控件沒有可點選的點。
UIA_ControlTypePropertyId ScrollBar 所有架構的這個值都相同。 做為滑桿的滾動條必須使用 滑桿 控件類型。
UIA_IsContentElementPropertyId 假 滾動條控件絕不是內容元素。 如果滾動條是獨立控件，它必須滿足 Slider 控件類型，並傳回 IUIAutomationElement：：CurrentControlType （或 CachedControlType） 属性 UIA_SliderControlTypeId。
UIA_IsControlElementPropertyId 真 滾動條控件一律包含在UI自動化樹狀結構的控件檢視中。
UIA_IsKeyboardFocusablePropertyId 請參閱附注。 如果控件可以接收鍵盤焦點，它必須支援這個屬性。 滾動條控件很少取得焦點，但當焦點發生時，焦點應該保留在滾動條控件本身，而不是子按鈕或拇指上。 用戶應該能夠使用向上鍵和向下箭號（或向右鍵和向左鍵）鍵，或PAGE向上鍵和向下鍵來執行所有捲動動作。
UIA_LabeledByPropertyId 零 滾動條沒有標籤。
UIA_LocalizedControlTypePropertyId 請參閱附注。 對應至 ScrollBar 控件類型的當地語系化字串。 默認值為 en-US 或英文（美國）的「滾動條」。
UIA_NamePropertyId 零 滾動條控件沒有內容元素，而且不需要設定 UIA_NamePropertyId 屬性。
UIA_OrientationPropertyId 請參閱附注。 滾動條控件必須一律公開其水準或垂直方向。

 

必要的控制件模式

下表列出所有滾動條控件都必須支援的UI自動化控制件模式。 如需控制樣式的詳細資訊，請參閱 UI 自動化控制樣式概觀。

注意

當滾動條僅當做滑鼠作的控件使用時，它不支援控件模式。 如果它做為應用程式內的滑桿控件，則必須提供 Slider 控件類型。

 

控制件模式 支援 筆記
IRangeValueProvider 取決於 只有當具有滾動條的容器不支援 Scroll 控件模式時，才需要支援 RangeValue 控件模式。
IScrollProvider 從不 滾動條上永遠不會直接支援 卷動 控件模式。

 

必要事件

下表列出滾動條控制項需要支援的UI自動化事件。 如需事件的詳細資訊，請參閱 UI 自動化事件概觀。

UI 自動化事件 筆記
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId 屬性變更事件。
UIA_IsEnabledPropertyId 屬性變更事件。 如果控件支援 IsEnabled 屬性，則必須支援這個事件。
UIA_IsOffscreenPropertyId 屬性變更事件。 如果控件支援 IsOffscreen 屬性，它就必須支援這個事件。
UIA_StructureChangedEventId
UIA_RangeValueValuePropertyId 屬性變更事件。 如果控件支援 RangeValue 控件模式，則必須支援此事件。

 

概念

UI 自動化控制項類型概觀

UI 自動化概觀