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

  • [アーティクル]

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

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

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

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

一般的なツリー構造

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

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

 

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

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

関連するプロパティ

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

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

 

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

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

コントロール パターン サポート Notes
IGridItemProvider 依存 テキスト コントロールがテーブル コントロール内に含まれている場合は、 GridItem コントロール パターンをサポートする必要があります。
ITableItemProvider 依存 テキスト コントロールがテーブル コントロール内に含まれている場合は、 TableItem コントロール パターンをサポートする必要があります。
ITextProvider 依存 テキストは、アクセシビリティを向上するために テキスト コントロール パターンをサポートする必要があります。ただし、必須ではありません。 テキストにさまざまなスタイルや属性 (たとえば、色、太字、斜体など) がある場合、Text コントロール パターンの使用をお勧めします。
IValueProvider 行わない テキスト コントロールは 、値 コントロール パターンをサポートしません。 テキストが編集可能な場合は、 編集 コントロールの種類になります。

 

必須イベント

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

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

 

概念

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

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