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

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

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

Thumb コントロールは、スクロール バー ボタンなどのようにコントロールを移動 (またはドラッグ) したり、ウィンドウ サイズ変更ウィジェットなどのようにコントロールのサイズを変更できるようにする機能を提供します。 Thumb コントロールは、ペインの移動可能な境界線としても実装できます。 ドラッグ アンド ドロップ機能は提供していないことに注意してください。 つまみコントロールは、マウス フォーカスを受け取ることはできますが、通常、キーボード フォーカスを受け取ることはできません。 コントロールの開発者は、適切に動作するように (ドラッグまたはサイズ変更できるように) コントロールを実装する必要があります。

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

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

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

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

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

コントロール ビュー	コンテンツ ビュー
Thumb	適用なし

つまみコントロールは、マウスで操作するためにのみ存在するので、コンテンツ ビューには表示されません。 つまみコントロールの機能は、つまみコンテナーでサポートされている Scroll パターン、Transform パターン、RangeValue パターンなどの別のコントロール パターンをとおして公開されます。

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

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

UI Automation プロパティ	値	説明
AutomationIdProperty	説明を参照。	このプロパティの値は、アプリケーションのすべてのコントロールで一意にする必要があります。
BoundingRectangleProperty	説明を参照。	コントロール全体を包含する外側の四角形。
ClickablePointProperty	メモを参照。	Thumb コントロールの可視クライアント領域内の任意のポイント。
IsKeyboardFocusableProperty	説明を参照。	コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。
NameProperty	Null	Thumb コントロールは、UI オートメーション ツリーのコンテンツ ビューでは使用できないため、名前は必要ありません。
LabeledByProperty	Null	Thumb コントロールにはラベルはありません。
ControlTypeProperty	Thumb	この値は、すべての UI フレームワークで共通です。
LocalizedControlTypeProperty	"thumb"	Thumb コントロール型に対応するローカライズされた文字列。
IsContentElementProperty	False	Thumb コントロールはコンテンツではありません。
IsControlElementProperty	True	Thumb コントロールは、常にコントロールである必要があります。

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

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

コントロール パターン/パターン プロパティ	サポート/値	説明
ITransformProvider	必須	Thumb コントロールを画面上で移動できるようにします。

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

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

UI Automation イベント	サポート	説明
BoundingRectangleProperty プロパティ変更イベント	必須	なし
IsOffscreenProperty プロパティ変更イベント	必須	なし
IsEnabledProperty プロパティ変更イベント	必須	なし
AutomationFocusChangedEvent	必須	なし
StructureChangedEvent	必須	なし

参照

参照

Thumb

概念

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

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