UI オートメーションによる Slider コントロール型のサポート
.gif "メモ") メモ |
|---|
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージ UI Automation クラスを使用する .NET Framework 開発者を対象としています。UI Automationに関する最新情報については、「Windows Automation API: UI Automation (Windows オートメーション API: UI オートメーション)」を参照してください。 |
ここでは、Slider コントロール型に対する UI Automation サポートに関する情報を紹介します。 UI Automationでは、コントロール型は、ControlTypeProperty プロパティを使用するためにコントロールで満たす必要がある一連の条件となります。 これらの条件には、UI Automation ツリー構造、UI Automationのプロパティ値、およびコントロール型に関する特定のガイドラインが含まれます。
スライダー コントロールは複合コントロールで、マウスを使用して数値の範囲を設定したり、一連の項目から選択したりするためのボタンを備えています。
以下のセクションでは、Slider コントロール型で必要な UI Automation ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI Automationの各要件は、Windows Presentation Foundation (WPF)、Win32、Windows Formsのいずれの場合でも、すべてのスライダー コントロールに当てはまります。
このトピックは、次のセクションで構成されています。
- 必須の UI オートメーション ツリー構造
- 必須の UI オートメーション プロパティ
- 必須の UI オートメーション コントロール パターン
- 必須の UI オートメーション イベント
- 関連トピック
必須の UI オートメーション ツリー構造
次の表では、スライダー コントロールに関連した UI Automation ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに格納できるものについて説明します。 UI Automation ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
コントロール ビュー |
コンテンツ ビュー |
|---|---|
スライダー
|
スライダー
|
必須の UI オートメーション プロパティ
次の表に、値または定義が特に Slider コントロール型に関連する UI Automation プロパティを示します。 UI Automation プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。
UI Automation プロパティ |
値 |
説明 |
|---|---|---|
説明を参照。 |
このプロパティの値は、アプリケーションのすべてのコントロールで一意にする必要があります。 |
|
説明を参照。 |
コントロール全体を包含する外側の四角形。 |
|
メモを参照 |
ほとんどのスライダー コントロールは、スライダー コントロールの外接する四角形全体を子コントロールが占めるため、NoClickablePointException を発生させる必要があります。 |
|
説明を参照。 |
コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
|
説明を参照。 |
エディット コントロールの名前は、通常、静的テキスト ラベルから生成されます。 静的テキスト ラベルが存在しない場合は、アプリケーションの開発時に Name のプロパティ値を割り当てる必要があります。 Name プロパティには、エディット コントロールのテキスト コンテンツを含めることができません。 |
|
説明を参照。 |
コントロールに関連付けられた静的テキスト ラベルが存在する場合、このプロパティは、そのコントロールへの参照を公開する必要があります。 テキスト コントロールが別のコントロールのサブコンポーネントである場合、LabeledBy プロパティは設定されません。 |
|
Slider |
この値は、すべての UI フレームワークで共通です。 |
|
"スライダー" |
Edit コントロール型に対応する、ローカライズされた文字列。 |
|
True |
エディット コントロールは、常に UI Automation ツリーのコンテンツ ビューに含まれます。 |
|
True |
エディット コントロールは、常に UI Automation ツリーのコントロール ビューに含まれます。 |
必須の UI オートメーション コントロール パターン
次の表に、すべてのスライダー コントロールでサポートする必要がある UI Automation コントロール パターンの一覧を示します。 コントロール パターンの詳細については、「UI オートメーション コントロール パターンの概要」を参照してください。
コントロール パターン |
サポート |
説明 |
|---|---|---|
依存 |
コンテンツが独立したオプション セットのうちの 1 つの値を表す場合、スライダーは Selection コントロール パターンをサポートする必要があります。 Selection コントロール パターンがサポートされている場合、対応する選択項目は、スライダーの 1 つ以上の子リスト項目として公開する必要があります。 |
|
依存 |
コンテンツを数値範囲内の 1 つの値に設定できる場合、スライダーは RangeValue コントロールをサポートする必要があります。 |
|
依存 |
コンテンツが独立したオプション セットのうちの 1 つの値を表す場合、スライダーは Value コントロール パターンをサポートする必要があります。 |
必須の UI オートメーション イベント
次の表に、すべてのスライダー コントロールでサポートする必要がある UI Automation イベントを示します。
イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。
UI Automation イベント |
サポート |
説明 |
|---|---|---|
依存 |
なし |
|
BoundingRectangleProperty プロパティ変更イベント |
必須 |
なし |
IsOffscreenProperty プロパティ変更イベント |
必須 |
なし |
IsEnabledProperty プロパティ変更イベント |
必須 |
なし |
ValueProperty プロパティ変更イベント |
依存 |
なし |
必須 |
なし |
|
必須 |
なし |