共用方式為


滑桿控制件類型的UI自動化支援

備註

本檔適用於想要使用 System.Windows.Automation 命名空間中定義的受控UI自動化類別的 .NET Framework 開發人員。 如需 UI 自動化的最新資訊,請參閱 Windows 自動化 API:使用者介面自動化

本主題提供 Slider 控制項類型的 UI 自動化支援相關信息。 在UI自動化中,控件類型是控制項必須符合的一組條件,才能使用 ControlTypeProperty 屬性。 這些條件包括UI自動化樹狀結構、UI自動化屬性值和控件類型的特定指導方針。

Slider 控制項是具有按鈕的複合控制項,可讓使用者使用滑鼠來設定數值範圍,或從一組項目選取。

下列各節會定義 Slider 控制項類型所需的 UI 自動化樹狀結構、屬性、控制件模式和事件。 使用者介面自動化需求適用於所有滑桿控件,無論是 Windows Presentation Foundation (WPF)、Win32 或 Windows Forms。

必要的 UI 自動化樹狀結構

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

控制項檢視 內容檢視
滑桿

- 按鈕 (2 或 4)
- 拇指 (僅 1)
- 清單項目 (0 個以上)
滑桿

- 清單項目 (0 個以上)

必要的UI自動化屬性

下表列出UI自動化屬性,其值或定義與Slider控件類型特別相關。 如需UI自動化屬性的詳細資訊,請參閱 用戶端的UI自動化屬性

UI 自動化屬性 價值觀 註釋
AutomationIdProperty 請參閱備註。 這個屬性的值在應用程式中的所有控件中必須是唯一的。
BoundingRectangleProperty 請參閱備註。 包含整個控制項的最外層矩形。
ClickablePointProperty 請參閱附注 大部分的滑桿控件必須引發 NoClickablePointException ,因為滑桿控件的整個邊界矩形都被子控件所佔用。
IsKeyboardFocusableProperty 請參閱備註。 如果控制項可接收鍵盤焦點,就必定支援此屬性。
NameProperty 請參閱備註。 編輯控制元件的名稱通常是從靜態文字捲標產生。 如果沒有靜態文字標籤,應用程式開發人員必須指派一個Name的屬性值。 屬性 Name 絕對不應該包含編輯控件的文字內容。
LabeledByProperty 請參閱備註。 如果有與控件相關聯的靜態文字標籤,則此屬性必須公開該控件的參考。 如果文字控制項是另一個控件的子元件,它就不會設定 LabeledBy 屬性。
ControlTypeProperty 滑桿 此值與所有使用者介面架構的值相同。
LocalizedControlTypeProperty 滑桿 對應至編輯控制項類型的當地語系化字串。
IsContentElementProperty 編輯控制項一律包含在使用者介面自動化樹狀結構的內容檢視中。
IsControlElementProperty 編輯控件一律包含在UI自動化樹狀結構的控件檢視中。

必要的使用者介面自動化控制模式

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

控制件模式 支援 註釋
ISelectionProvider 視情況而定 如果內容代表一組離散選項中的一個值,滑桿應該支持選取控件模式。 支援 [選取範圍] 控件模式時,對應的選取範圍必須公開為滑桿的一或多個子清單專案。
IRangeValueProvider 視情況而定 如果內容可以設定為數值範圍內的值,滑桿應該支援 RangeValue 控件模式。
IValueProvider 視情況而定 如果內容代表一組離散選項中的一個值,滑桿應該支援 Value 控件模式。

必要的UI自動化事件

下表列出所有滑桿控件都必須支援的UI自動化事件。

如需事件的詳細資訊,請參閱 UI Automation Events Overview

UI 自動化事件 支援 註釋
InvalidatedEvent 視情況而定 沒有
BoundingRectangleProperty 屬性變更事件 為必填項目 沒有
IsOffscreenProperty 屬性變更事件 為必填項目 沒有
IsEnabledProperty 屬性變更事件 為必填項目 沒有
ValueProperty 屬性變更事件 視情況而定 沒有
AutomationFocusChangedEvent 為必填項目 沒有
StructureChangedEvent 為必填項目 沒有

另請參閱