UI オートメーションによる Slider コントロール型のサポート

更新 : 2007 年 11 月

ここでは、Slider コントロール型に対する UI オートメーション サポートに関する情報を紹介します。UI オートメーションでは、コントロール型は、ControlTypeProperty プロパティを使用するためにコントロールで満たす必要がある一連の条件となります。これらの条件には、UI オートメーション ツリー構造、UI オートメーションのプロパティ値、およびコントロール型に関する特定のガイドラインが含まれます。

スライダ コントロールは複合コントロールで、マウスを使用して数値の範囲を設定したり、一連の項目から選択したりするためのボタンを備えています。

以下のセクションでは、Slider コントロール型で必要な UI オートメーション ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。UI オートメーションの各要件は、Windows Presentation Foundation (WPF)、Win32、Windows フォームのいずれの場合でも、すべてのスライダ コントロールに当てはまります。

このトピックには次のセクションが含まれています。

• 必須の UI オートメーション ツリー構造
• 必須の UI オートメーション プロパティ
• 必須の UI オートメーション コントロール パターン
• 必須の UI オートメーション イベント
• 関連トピック

必須の UI オートメーション ツリー構造

次の表では、スライダ コントロールに関連した UI オートメーション ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに格納できるものについて説明します。UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。

コントロール ビュー	コンテンツ ビュー
Slider ボタン (2 つ、または 4 つ) つまみ (1 つだけ) リスト項目 (2 つ以上)	Slider リスト項目 (2 つ以上)

必須の UI オートメーション プロパティ

次の表に、値または定義が特に Slider コントロール型に関連する UI オートメーション プロパティを示します。UI オートメーション プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。

UI オートメーション プロパティ	値	説明
AutomationIdProperty()	説明を参照。	このプロパティの値は、アプリケーションのすべてのコントロールで一意にする必要があります。
BoundingRectangleProperty	説明を参照。	コントロール全体を包含する外側の四角形。
ClickablePointProperty	説明を参照。	ほとんどのスライダ コントロールは、スライダ コントロールの外接する四角形全体を子コントロールが占めるため、NoClickablePointException を発生させる必要があります。
IsKeyboardFocusableProperty	説明を参照。	コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。
NameProperty	説明を参照。	エディット コントロールの名前は、通常、静的テキスト ラベルから生成されます。静的テキスト ラベルが存在しない場合は、アプリケーションの開発時に Name のプロパティ値を割り当てる必要があります。Name プロパティには、エディット コントロールのテキスト コンテンツを含めることができません。
LabeledByProperty	説明を参照。	コントロールに関連付けられた静的テキスト ラベルが存在する場合、このプロパティは、そのコントロールへの参照を公開する必要があります。テキスト コントロールが別のコントロールのサブコンポーネントである場合、LabeledBy プロパティは設定されません。
ControlTypeProperty	Slider	この値は、すべての UI フレームワークで共通です。
LocalizedControlTypeProperty	"スライダ"	Edit コントロール型に対応する、ローカライズされた文字列。
IsContentElementProperty	True	エディット コントロールは、常に UI オートメーション ツリーのコンテンツ ビューに含まれます。
IsControlElementProperty	True	エディット コントロールは、常に UI オートメーション ツリーのコントロール ビューに含まれます。

必須の UI オートメーション コントロール パターン

次の表に、すべてのスライダ コントロールでサポートする必要がある UI オートメーション コントロール パターンの一覧を示します。コントロール パターンの詳細については、「UI オートメーション コントロール パターンの概要」を参照してください。

コントロール パターン/コントロール パターン プロパティ	サポート/値	説明
ISelectionProvider	依存	コンテンツが不連続の値かどうかによって異なります。
IRangeValueProvider	依存	コンテンツを数値範囲内で設定できるかどうかにより異なります。

必須の UI オートメーション イベント

次の表に、すべてのスライダ コントロールでサポートする必要がある UI オートメーション イベントを示します。

イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。

UI オートメーション イベント	サポート	説明
InvalidatedEvent	依存	なし
BoundingRectangleProperty	必須	なし
IsOffscreenProperty	必須	なし
IsEnabledProperty	必須	なし
ValueProperty	依存	なし
AutomationFocusChangedEvent	必須	なし
StructureChangedEvent	必須	なし

参照

概念

UI オートメーション コントロール型の概要

UI オートメーションの概要

参照

Slider