次の方法で共有


UI オートメーション RangeValue コントロール パターンの実装

このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージド UI オートメーション クラスを使用する .NET Framework 開発者を対象としています。 UI オートメーションの最新情報については、「Windows Automation API: UI オートメーション 」を参照してください。

このトピックでは、イベントとプロパティに関する情報など、 IRangeValueProviderを実装するためのガイドラインと規則について説明します。 その他の参照へのリンクは、トピックの最後に一覧表示されます。

RangeValuePattern コントロール パターンは、範囲内の値に設定できるコントロールをサポートするために使用されます。 このコントロール パターンを実装するコントロールの例については、「UI オートメーション クライアントのコントロール パターン マッピング 」を参照してください。

実装のガイドラインと規則

Range Value コントロール パターンを実装する場合は、次のガイドラインと規則に注意してください。

  • コントロールを使用すると、ロケールまたはユーザー設定に基づいて、サポートされているプロパティを再調整できます。 この例は、華氏または摂氏の温度を表示するように設定できる温度計コントロールです。

  • 進行状況バーやスライダーなど、あいまいな範囲の値を持つコントロールでは、それらの値を正規化する必要があります。

進行状況バー。 値が整数型で、プロパティ値の最小値と最大値がそれぞれ 0 と 100 に正規化されている進行状況バーの例

IRangeValueProvider の必須メンバー

必須メンバー メンバーの種類 注記
IsReadOnlyProperty プロパティ 無し
ValueProperty プロパティ 無し
LargeChangeProperty プロパティ 無し
SmallChangeProperty プロパティ 無し
MaximumProperty プロパティ 無し
MinimumProperty プロパティ 無し
SetValue メソッド 無し

このコントロール パターンには、関連付けられたイベントはありません。

例外

プロバイダーは、次の例外をスローする必要があります。

例外の種類 条件
ArgumentOutOfRangeException SetValue は、 MaximumProperty より大きい値または MinimumProperty未満の値で呼び出されます。

こちらも参照ください