共用方式為


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

注意事項注意事項

這份文件適用於想要使用 System.Windows.Automation 命名空間中定義之 Managed UI Automation 類別的 .NET Framework 開發人員。如需 UI Automation 的最新資訊,請參閱 Windows Automation API:使用者介面自動化 (英文)。

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

RangeValuePattern 控制項模式是用來支援可設為範圍值的控制項。 如需實作此控制項模式的控制項範例,請參閱 UI 自動化用戶端的控制項模式對應

這個主題包含下列章節。

  • 實作方針和慣例
  • IRangeValueProvider 的必要成員
  • 例外狀況
  • 相關主題

實作方針和慣例

實作範圍值 (Range Value) 控制項模式時,請注意下列方針和慣例:

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

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

以下為進度列範例,其中的值屬於整數型別,而最小值和最大值的屬性值分別正規化為 0 和 100

進度列。

IRangeValueProvider 的必要成員

必要成員

成員類型

備註

IsReadOnlyProperty

屬性

ValueProperty

屬性

LargeChangeProperty

屬性

SmallChangeProperty

屬性

MaximumProperty

屬性

MinimumProperty

屬性

SetValue

方法

這個控制項模式沒有相關事件。

例外狀況

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

例外狀況類型

條件

ArgumentOutOfRangeException

SetValue 呼叫時所使用的值大於 MaximumProperty 或小於 MinimumProperty

請參閱

工作

支援 UI 自動化提供者的控制項模式

使用 UI 自動化中的快取

概念

UI 自動化控制項模式概觀

用戶端的 UI 自動化控制項模式

UI 自動化樹狀目錄概觀