實作 UI 自動化 RangeValue 控制項模式

  • 發行項

注意

本文件適用對象為 .NET Framework 開發人員，其想要使用 System.Windows.Automation 命名空間中定義的受控 UI 自動化類別。 如需 UI 自動化的最新資訊，請參閱 Windows 自動化 API：UI 自動化。

本主題將介紹實作 IRangeValueProvider的方針和慣例，包括事件和屬性的相關資訊。 其他參考的連結列於此主題的結尾部分。

RangeValuePattern 控制項模式用來支援可以設定為某範圍內的值之控制項。 如需實作此控制項模式的控制項範例，請參閱 Control Pattern Mapping for UI Automation Clients。

實作方針和慣例

實作範圍值控制項模式時，請注意下列方針和慣例：

  • 控制項可以根據地區設定或使用者偏好設定，重新劃分所支援屬性的刻度。 例如，溫度計控制項可以設為顯示華氏或攝氏溫度。

  • 範圍值不明確的控制項 (如進度列或滑桿) 應將這些值正規化。

Progress bar. 進度列範例，其中的值屬於整數類型，而最小值和最大值的屬性值分別正規化為 0 和 100

IRangeValueProvider 的必要成員

必要成員 成員類型 備註
IsReadOnlyProperty 屬性 無
ValueProperty 屬性 無
LargeChangeProperty 屬性 無
SmallChangeProperty 屬性 無
MaximumProperty 屬性 無
MinimumProperty 屬性 無
SetValue 方法 無

此控制項模式沒有任何相關聯的事件。

例外狀況

提供者必須擲回下列例外狀況。

例外狀況類型 Condition
ArgumentOutOfRangeException SetValue 以大於 MaximumProperty 或小於 MinimumProperty的值呼叫。

另請參閱