次の方法で共有

テキスト コントロールの種類

  • [アーティクル]

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

テキスト コントロールは、画面上のテキストを表す基本的なユーザー インターフェイス項目です。

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

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

一般的なツリー構造

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

コントロール ビュー コンテンツ ビュー
  • テキスト
  • テキスト (コンテンツの場合)

 

テキスト コントロールは、フォーム上のラベルまたは静的テキストとして単独で使用できます。 また、次のいずれかの項目の構造内に含めることもできます。

テキスト は、他のコントロールの Name プロパティを介して表示されることが多いため、UI オートメーション ツリーのコンテンツ ビューにテキスト コントロールが表示されない場合があります。 たとえば、コンボ ボックス コントロールのラベル付けに使用されるテキストは、コントロールの Name プロパティを通じて公開されます。 コンボ ボックス コントロールは UI オートメーション ツリーのコンテンツ ビューにあるため、テキスト コントロールが存在する必要はありません。 ハイパーリンクなどの埋め込みオブジェクトがある場合、テキスト コントロールはコンテンツ ビューに子を含めることができます。

関連するプロパティ

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

UI オートメーション プロパティ 価値 筆記
UIA_AutomationIdPropertyId ノートを参照してください。 このプロパティの値は、UI オートメーション ツリーの生ビュー内のすべてのピア要素で一意である必要があります。
UIA_BoundingRectanglePropertyId ノートを参照してください。 コントロール全体を含む最も外側の四角形。
UIA_ClickablePointPropertyId ノートを参照してください。 外接する四角形がある場合にサポートされます。 外接する四角形内のすべてのポイントがクリック可能でなく、要素が特殊なヒット テストを実行する場合は、オーバーライドしてクリック可能なポイントを指定します。
UIA_ControlTypePropertyId テキスト
UIA_IsContentElementPropertyId 依存 テキスト コントロールは、別のコントロールの Name プロパティに公開されていない情報が含まれている場合はコンテンツです。
UIA_IsControlElementPropertyId 真 テキスト コントロールは常にコントロールである必要があります。
UIA_IsKeyboardFocusablePropertyId ノートを参照してください。 コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。
UIA_LabeledByPropertyId ヌル テキスト コントロールには静的なテキスト ラベルがありません。
UIA_LocalizedControlTypePropertyId ノートを参照してください。 Text コントロール型に対応するローカライズされた文字列。 既定値は、en-US または英語 (米国) の場合は "text" です。
UIA_NamePropertyId ノートを参照してください。 テキスト コントロールの名前には、表示するテキストを指定できます。 ただし、コントロールが Text パターンもサポートしていて、テキストが広範な場合は、Name 値としてフルテキスト コンテンツを使用しないでください。 代わりに、コントロールの他のプロパティから派生した短い Name 値を指定します。

 

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

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

コントロール パターン 支える 筆記
IGridItemProviderの 依存 テキスト コントロールがテーブル コントロール内に含まれている場合は、GridItem コントロール パターンがサポートされている必要があります。
ITableItemProviderの 依存 テキスト コントロールがテーブル コントロール内に含まれている場合は、TableItem コントロール パターンをサポートする必要があります。
ITextProviderの 依存 テキストは、アクセシビリティを向上 Text コントロール パターンをサポートする必要があります。ただし、必須ではありません。 テキスト コントロール パターンは、テキストに豊富なスタイルと属性 (色、太字、斜体など) がある場合に便利です。
IValueProviderの 一度もない テキスト コントロールでは、Value コントロール パターンはサポートされません。 テキストが編集可能な場合は、編集 コントロールの種類です。

 

必要なイベント

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

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

 

概念

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

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