次の方法で共有

Thumb コントロールの種類

  • [アーティクル]

このトピックでは、Microsoft UI オートメーション Thumb コントロール型のサポートに関する情報を提供します。

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

次のセクションでは、Thumb コントロール型に必要なUI オートメーションツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI オートメーションの要件は、UI フレームワーク/プラットフォームがコントロールの種類とコントロール パターンのサポートUI オートメーション統合するすべてのサム コントロールを適用します。

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

一般的なツリー構造

次の表は、サム コントロールに関連するUI オートメーション ツリーの一般的なコントロールとコンテンツ ビューを示し、各ビューに含めることができる内容について説明します。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。

コントロール ビュー コンテンツ ビュー
  • つまみ
 (該当なし)

 

サム コントロールは、マウスで操作するためだけに存在するため、コンテンツ ビューには表示されません。 これらは、サム コントロールのコンテナーでサポートされている 、スクロール コントロール パターン、 変換 コントロール パターン、 RangeValue コントロール パターンなどの別のコントロール パターンを使用して公開されます。

関連するプロパティ

次の表に、Thumb コントロールに特に関連する値または定義を持つ UI オートメーション プロパティを示します。 UI オートメーションプロパティの詳細については、「UI オートメーション要素からのプロパティの取得」を参照してください。

UI Automation のプロパティ 値 メモ
UIA_AutomationIdPropertyId 「ノート」を参照してください。 このプロパティの値は、UI オートメーション ツリーの生ビュー内のすべてのピア要素間で一意である必要があります。
UIA_BoundingRectanglePropertyId 「ノート」を参照してください。 コントロール全体を格納する最も外側の四角形。
UIA_ClickablePointPropertyId 「ノート」を参照してください。 サム コントロールの表示されるクライアント領域内のポイント。
UIA_ControlTypePropertyId つまみ
UIA_IsContentElementPropertyId FALSE サム コントロールは、UI オートメーション ツリーのコンテンツ ビューには含まれません。
UIA_IsControlElementPropertyId true サム コントロールは常に、UI オートメーション ツリーのコントロール ビューに含まれます。
UIA_IsKeyboardFocusablePropertyId 「ノート」を参照してください。 コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 サム コントロールは、ウィンドウまたはウィンドウのサイズを設定するための "グリッパー" オブジェクトとして使用されている場合に、フォーカスを受け取ることができます。 スライダーまたはスクロール バーのサム コントロールがフォーカスを受け取ることはありません。
UIA_LabeledByPropertyId NULL Thumb コントロールにラベルはありません。
UIA_LocalizedControlTypePropertyId 「ノート」を参照してください。 Thumb コントロール型に対応するローカライズされた文字列。 既定値は、en-US または英語 (米国) の "thumb" です。
UIA_NamePropertyId NULL サム コントロールは、UI オートメーション ツリーのコンテンツ ビューでは使用できないため、名前は必要ありません。

 

必須のコントロール パターン

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

コントロール パターン サポート Notes
ITransformProvider 必須 Thumb コントロールを画面で移動できるようにします。 通常、サム コントロールのサイズ変更や回転はできないため、 Transform コントロール パターンは主に Move 関数をサポートします。

 

必須イベント

次の表に、サム コントロールがサポートするために必要なUI オートメーション イベントの一覧を示します。 イベントの詳細については、「 UI Automation Events Overview」を参照してください。

UI オートメーション イベント メモ
UIA_AutomationFocusChangedEventId
プロパティ変更イベントUIA_BoundingRectanglePropertyId 。
プロパティ変更イベントUIA_IsEnabledPropertyId。 コントロールが IsEnabled プロパティをサポートしている場合は、このイベントをサポートする必要があります。
プロパティ変更イベントUIA_IsOffscreenPropertyId。 コントロールが IsOffscreen プロパティをサポートしている場合は、このイベントをサポートする必要があります。
UIA_StructureChangedEventId

 

概念

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

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