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

更新 : 2007 年 11 月

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

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

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

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

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

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

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

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

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

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

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

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

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

つまみコントロールは、どのコントロール パターンもサポートする必要はありません。

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

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

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

参照

概念

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

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

参照

Thumb