共用方式為


ScrollBar 控制項類型

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

捲軸控制項可讓使用者捲動視窗或項目容器內的內容。 控制項是由一組按鈕和指紋控制項所組成。

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

本主題包含下列各節。

一般樹狀結構

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

控制項檢視 內容檢視
  • ScrollBar
    • 按鈕 (0、2 或 4)
    • Thumb (0 或 1)
不適用。 (捲軸控制項沒有 content.)

 

捲軸控制項可以有零到五個子系。 因為子樹具有多個按鈕控制項,所以元素必須將特定 UIA_AutomationIdPropertyId 值設定為每個專案,使其可供自動測試控管探索。

相關屬性

下表列出的 UI 自動化屬性,其值或定義與捲軸控制項特別有關。 請注意,捲軸控制項永遠不會有內容;其功能會透過 動控制項模式來公開,而捲動的容器支援此功能。

如需消費者介面自動化屬性的詳細資訊,請參閱從 消費者介面自動化 Elements 擷取屬性

使用者介面自動化屬性 注意
UIA_AutomationIdPropertyId 請參閱備註。 此屬性的值在消費者介面自動化樹狀結構的原始檢視中,所有對等專案都必須是唯一的。
UIA_BoundingRectanglePropertyId 請參閱備註。 包含整個控制項的最外層矩形。
UIA_ClickablePointPropertyId NaN 捲軸控制項沒有可點選的點。
UIA_ControlTypePropertyId ScrollBar 此值與所有架構的值相同。 做為滑杆的捲軸必須使用 Slider 控制項類型。
UIA_IsContentElementPropertyId false 捲軸控制項不是內容項目。 如果捲軸是獨立控制項,它必須滿足Slider控制項類型,並傳回IUIAutomationElement::CurrentControlType (或CachedControlType) 屬性的UIA_SliderControlTypeId
UIA_IsControlElementPropertyId true 捲軸控制項一律包含在消費者介面自動化樹狀結構的控制項檢視中。
UIA_IsKeyboardFocusablePropertyId 請參閱備註。 如果控制項可接收鍵盤焦點,就必定支援此屬性。 捲軸控制項很少會取得焦點,但當它這樣做時,焦點應該保留在捲軸控制項本身上,而不是在子按鈕或指紋上。 使用者應該能夠使用向上鍵和向下鍵 (或向右鍵和向左) 鍵執行所有捲動動作,或頁面向上鍵和頁面向下鍵。
UIA_LabeledByPropertyId NULL 捲軸沒有標籤。
UIA_LocalizedControlTypePropertyId 請參閱備註。 對應至 ScrollBar 控制項類型的當地語系化字串。 預設值為 en-US 或英文 (美國) 的「捲軸」。
UIA_NamePropertyId NULL 捲軸控制項沒有內容元素,而且不需要設定 UIA_NamePropertyId 屬性。
UIA_OrientationPropertyId 請參閱備註。 捲軸控制項必須一律公開其水平或垂直的方向。

 

必要的控制項模式

下表列出所有捲軸控制項必須支援的消費者介面自動化控制項模式。 如需控制項模式的詳細資訊,請參閱 UI Automation Control Patterns Overview

注意

當捲軸只做為滑鼠操作的控制項時,它不支援控制項模式。 如果它用來作為應用程式內的滑杆控制項,則必須提供 Slider 控制項類型。

 

控制項模式 支援 備註
IRangeValueProvider 相依 只有在具有捲軸的容器上不支援Scroll控制項模式時,才需要支援RangeValue控制項模式。
IScrollProvider 永不 捲軸上永遠不會直接支援 動控制項模式。

 

必要的事件

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

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

 

概念

UI 自動化控制項類型概觀

UI 自動化概觀