UI オートメーションによる Thumb コントロール型のサポートUI Automation Support for the Thumb Control Type


このドキュメントは、UI オートメーションUI Automation 名前空間で定義されているマネージド System.Windows.Automation クラスを使用する .NET Framework 開発者を対象としています。This documentation is intended for .NET Framework developers who want to use the managed UI オートメーションUI Automation classes defined in the System.Windows.Automation namespace. UI オートメーションUI Automationの最新情報については、「 Windows Automation API: UI オートメーション」をご覧ください。For the latest information about UI オートメーションUI Automation, see Windows Automation API: UI Automation.

このトピックでは、Thumb コントロール型に対する UI オートメーションUI Automation のサポートについて説明します。This topic provides information about UI オートメーションUI Automation support for the Thumb control type. UI オートメーションUI Automationでのコントロール型とは、コントロールが ControlTypeProperty プロパティを使用するために満たす必要がある一連の条件のことです。In UI オートメーションUI Automation, a control type is a set of conditions that a control must meet in order to use the ControlTypeProperty property. これらの条件には、 UI オートメーションUI Automation ツリー構造、 UI オートメーションUI Automation のプロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。The conditions include specific guidelines for UI オートメーションUI Automation tree structure, UI オートメーションUI Automation property values, and control patterns.

Thumb コントロールは、スクロール バー ボタンなどのようにコントロールを移動 (またはドラッグ) したり、ウィンドウ サイズ変更ウィジェットなどのようにサイズ変更したりできる機能を提供します。Thumb controls provide the functionality that enables a control to be moved (or dragged), such as a scroll bar button, or resized, such as a window resizing widget. Thumb コントロールは、ウィンドウの移動可能な枠線として実装することもできます。Thumb controls can also be implemented as movable borders of panes. ドラッグ アンド ドロップ機能は提供されないことに注意してください。Note that it does not provide drag-and-drop functionality. Thumb コントロールは、マウス フォーカスを受け取ることはできますが、通常キーボード フォーカスを受け取ることはできません。Thumb controls can receive mouse focus but usually not keyboard focus. コントロール開発者は、適切に動作するように (ドラッグしたりサイズ変更したりできるように)、コントロールを実装する必要があります。The control developer must implement the control so that it acts appropriately (can be dragged or resized).

以下の各セクションで、Thumb コントロール型に必要な UI オートメーションUI Automation ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。The following sections define the required UI オートメーションUI Automation tree structure, properties, control patterns, and events for the Thumb control type. 要件は、、Win32、Windows フォームのいずれの場合で UI オートメーションUI Automation も、すべての thumb コントロールに適用され Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) ます。The UI オートメーションUI Automation requirements apply to all thumb controls, whether Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF), Win32, or Windows Forms.

必須の UI オートメーション ツリー構造Required UI Automation Tree Structure

次の表に、Thumb コントロールに関連する UI オートメーションUI Automation ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。The following table depicts the control view and the content view of the UI オートメーションUI Automation tree that pertains to thumb controls and describes what can be contained in each view. ツリーの詳細につい UI オートメーションUI Automation ては、「 UI オートメーションツリーの概要」を参照してください。For more information on the UI オートメーションUI Automation tree, see UI Automation Tree Overview.

コントロール ビューControl View コンテンツ ビューContent View
つまみThumb -該当なし- Not applicable

Thumb コントロールは、マウスを使用して操作するためだけに存在しているので、コンテンツ ビューには表示されません。Thumb controls never appear in Content View because they only exist for being manipulated with a mouse. これらの機能は、Thumb コンテナーでサポートされる Scroll パターン、Transform パターン、RangeValue パターンなど別のコントロール パターンを使用して公開されます。Their functionality is exposed though another control pattern, such as Scroll Pattern, Transform Pattern, or RangeValue Pattern, being supported on the Thumb container.

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

次の表に、Thumb コントロールに特に関連する値または定義を持つ UI オートメーションUI Automation プロパティを示します。The following table lists the UI オートメーションUI Automation properties whose value or definition is especially relevant to thumb controls. プロパティの詳細につい UI オートメーションUI Automation ては、「クライアントの UI オートメーションのプロパティ」を参照してください。For more information on UI オートメーションUI Automation properties, see UI Automation Properties for Clients.

UI オートメーションUI Automation プロパティProperty Value メモNotes
AutomationIdProperty 「ノート」を参照してください。See notes. このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。The value of this property needs to be unique across all controls in an application.
BoundingRectangleProperty 「ノート」を参照してください。See notes. コントロール全体を格納する最も外側の四角形。The outermost rectangle that contains the whole control.
ClickablePointProperty 「ノート」を参照してください。See notes. Thumb コントロールの表示されているクライアント領域内の任意のポイント。Any point within the visible client area of the Thumb control.
IsKeyboardFocusableProperty 「ノート」を参照してください。See notes. コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。If the control can receive keyboard focus, it must support this property.
NameProperty Null Thumb コントロールは、UI オートメーション ツリーのコンテンツ ビューには表示されないため、名前は不要です。The Thumb control is not available in the Content View of the UI Automation tree so it does not require a name.
LabeledByProperty Null Thumb コントロールにラベルはありません。Thumb controls never have a label.
ControlTypeProperty つまみThumb この値は、すべての UI フレームワークで同じです。This value is the same for all UI frameworks.
LocalizedControlTypeProperty "Thumb""thumb" Thumb コントロール型に対応する、ローカライズされた文字列。Localized string corresponding to the Thumb control type.
IsContentElementProperty 誤りFalse Thumb コントロールにコンテンツはありません。The Thumb control is never content.
IsControlElementProperty 正しいTrue Thumb コントロールは、常にコントロールである必要があります。The Thumb control must always be a control.

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

次の表に、Thumb コントロールでサポートされなければならない UI オートメーションUI Automation コントロール パターンを示します。The following table lists the UI オートメーションUI Automation control patterns required to be supported by thumb controls. コントロール パターンの詳細については、「 UI Automation Control Patterns Overview」を参照してください。For more information on control patterns, see UI Automation Control Patterns Overview.

コントロール パターン/パターン プロパティControl Pattern/Pattern Property サポート/値Support/Value NotesNotes
ITransformProvider 必須Required Thumb コントロールを画面で移動できるようにします。Enables the thumb control to be moved on the screen.

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

次の表に、すべての Thumb コントロールでサポートされなければならない UI オートメーションUI Automation イベントを示します。The following table lists the UI オートメーションUI Automation events required to be supported by all thumb controls. イベントの詳細については、「 UI Automation Events Overview」を参照してください。For more information about events, see UI Automation Events Overview.

UI オートメーションUI Automation イベントEvent サポートSupport NotesNotes
BoundingRectangleProperty プロパティ変更イベント。BoundingRectangleProperty property-changed event. 必須Required なしNone
IsOffscreenProperty プロパティ変更イベント。IsOffscreenProperty property-changed event. 必須Required なしNone
IsEnabledProperty プロパティ変更イベント。IsEnabledProperty property-changed event. 必須Required なしNone
AutomationFocusChangedEvent 必須Required なしNone
StructureChangedEvent 必須Required なしNone

関連項目See also