イメージ コントロールの種類

  • [アーティクル]

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

アイコン、情報グラフィックス、グラフとして使用されるイメージ コントロールは、 イメージ コントロールの種類をサポートします。 背景または透かしの画像として使用されるコントロールでは、 イメージ コントロールの種類はサポートされません。

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

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

一般的なツリー構造

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

コントロール ビュー コンテンツ ビュー
Image イメージ ( Automation 要素プロパティ識別子 プロパティの値に基づいて、イメージに情報が含まれているかどうかによって異なります)

関連するプロパティ

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

UI Automation のプロパティ 値 Notes
UIA_AutomationIdPropertyId 「ノート」を参照してください。 このプロパティの値は、UI オートメーション ツリーの生ビュー内のすべてのピア要素間で一意である必要があります。
UIA_BoundingRectanglePropertyId 「ノート」を参照してください。 コントロール全体を格納する最も外側の四角形。
UIA_ClickablePointPropertyId 「ノート」を参照してください。 イメージ コントロールのクリック可能なポイントは、イメージ コントロールの外接する四角形内のポイントである必要があります。
UIA_ControlTypePropertyId イメージ
UIA_HelpTextPropertyId 「ノート」を参照してください。 HelpText プロパティは、イメージに関連付けられたコントロールまたはその他のツールヒント情報の実際の外観を説明するローカライズされた文字列を公開します。 このプロパティは、画像コントロールに関する詳細情報を伝えるために長い説明が必要な場合にサポートする必要があります (たとえば、画像が複雑なグラフや図の場合)。 このプロパティは、HTML LongDesc タグとスケーラブル ベクター グラフィックス (SVG) Desc タグに マップされます。 イメージ コントロールを使用する開発者は、コントロールに視覚的な説明を設定できるようにするために、プロパティをサポートする必要があります。 このプロパティは、UI オートメーション VisualDescription プロパティにマップする必要があります。
UIA_IsContentElementPropertyId 「ノート」を参照してください。 エンド ユーザーに対してまだ公開されていない有用な情報がイメージ コントロールに含まれている場合は、それを UI オートメーション ツリーのコンテンツ ビューに含める必要があります。
UIA_IsControlElementPropertyId true イメージ コントロールは、UI オートメーション ツリーのコントロール ビューに常に含まれます。
UIA_IsKeyboardFocusablePropertyId 「ノート」を参照してください。 コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。
UIA_ItemStatusPropertyId 「ノート」を参照してください。 イメージ コントロールが画面上の特定の項目に関する状態情報を表している場合は、そのコントロールを対象の項目に含める必要があります。 イメージがアイテム内に含まれている場合、アイテムは status プロパティをサポートし、状態が変更されたときに適切な通知を生成する必要があります。 イメージがスタンドアロン コントロールであり、状態を示している場合は、このプロパティをサポートする必要があります。
UIA_LabeledByPropertyId 「ノート」を参照してください。 静的テキスト ラベルがある場合、このプロパティは、そのコントロールへの参照を公開する必要があります。
UIA_LocalizedControlTypePropertyId 「ノート」を参照してください。 Image コントロールの種類に対応するローカライズされた文字列。 既定値は、en-US または英語 (米国) の "image" です。
UIA_NamePropertyId 「ノート」を参照してください。 Name プロパティは、情報を含むすべてのイメージ コントロールに対して公開する必要があります。 この情報にプログラムでアクセスするには、グラフィックと等価なテキストを指定する必要があります。 イメージ コントロールが純粋に装飾されている場合は、UI オートメーション ツリーのコントロール ビューにのみ表示する必要があり、名前を付ける必要はありません (「解説」を参照)。 UI フレームワークは、イメージ上の ALT (代替テキスト) プロパティをサポートする必要があります。これはそのフレームワークの内部から設定できます。 次いで、このプロパティは、UI オートメーションの Name プロパティにマップされます。

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

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

コントロール パターン サポート Notes
IGridItemProvider 依存 コントロールがグリッド コンテナー内にある場合、イメージ コントロールは GridItem コントロール パターンをサポートします。
IInvokeProvider 行わない イメージ コントロールがクリック可能なオブジェクトの場合、コントロールは、ボタン コントロールの種類などの Invoke コントロール パターンをサポートするコントロールの種類をサポートする必要があります。 複数のクリック可能なオブジェクトを含むイメージ オブジェクトの場合、要素 (イメージ コントロールの種類) は、UI オートメーション ツリーで子リンク (ハイパーリンク コントロールの種類) をホストできます。
ISelectionItemProvider 行わない イメージ コントロールは SelectionItem コントロール パターンをサポートしないでください。 イメージが、イメージ アイコンをコンテンツとして含むボタンなど、選択可能なコンテナーの一部である場合、そのコンテナーは、その中のイメージではなくパターンをサポートします。
ITableItemProvider 依存 コントロールがヘッダー コントロールを持つコンテナー内にある場合、イメージ コントロールは TableItem コントロール パターンをサポートします。

必須イベント

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

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

解説

World Wide Web Consortium (W3C) では、ページのコンテンツに情報を追加しない装飾イメージを定義します。 詳細については、 装飾画像に関する W3C トピックを参照してください。

UI オートメーションに関して:

  • 画像が純粋に装飾的であり、対話型ではなく、情報を伝達しない場合、画像は次のようになります。
    • UIA ツリーに存在する可能性がある、または存在しない可能性がある
    • UIA 未加工ビューに表示される場合とない場合があります
    • UIA コントロール ビューに含めてはいけません
    • コンテンツ ビューに含めてはいけません
    • 名前を持つ場合とない場合があります
  • 画像が情報を伝達するが、同じ情報を提供する明確に関連付けられたテキスト (左向きの三角形のグラフィックとテキスト "play" を含む再生ボタンなど) がある場合、画像は装飾と見なされ、画像は次のようになります。
    • 未加工のビューに存在する必要があります
    • コントロール ビューに存在する必要があります
    • コンテンツ ビューに含めてはいけません
    • Name プロパティに値が含まれている場合とない場合があります。
    • 画像の意味も伝えるテキストは、コンテンツ ビューに含まれている必要があります
  • 画像が有益であり、関連付けられたテキストによって提供されない詳細を伝える場合、画像は次のようになります。
    • 未加工のビューに存在する必要があります
    • コントロール ビューに存在する必要があります
    • コンテンツ ビューに存在する必要があります
    • イメージとその意味を説明する名前値を指定する必要があります

概念