次の方法で共有

Thumb コントロールの種類

  • [アーティクル]

このトピックでは、Thumb コントロールの種類に対する Microsoft UI オートメーションのサポートについて説明します。

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

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

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

一般的なツリー構造

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

コントロール ビュー コンテンツ ビュー
  • 親指
 (該当なし)

 

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

関連するプロパティ

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

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

 

必要なコントロール パターン

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

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

 

必要なイベント

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

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

 

概念

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

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