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

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

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

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

このトピックは、次のセクションで構成されています。

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

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

コントロールでは、ロケールまたはユーザー設定に基づいて、サポートされているプロパティを再補正できます。この例として、温度を華氏または摂氏で表示するように設定できる温度計コントロールがあります。
進行状況バーやスライダーなど、不明確な範囲の値を持つコントロールでは、値が正規化されている必要があります。

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

進行状況バー。

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

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

例外の種類	状態
ArgumentOutOfRangeException	MaximumProperty よりも大きいか、MinimumProperty よりも小さい値を使用して SetValue が呼び出されました。