イメージ コントロールの種類
このトピックでは、Image コントロールの種類に対する Microsoft UI オートメーションのサポートについて説明します。
アイコン、情報グラフィック、およびグラフとして使用されるイメージ コントロールは、Image コントロールの種類をサポートします。 背景または透かしの画像として使用されるコントロールでは、Image コントロールの種類はサポートされません。
次のセクションでは、Image コントロール型に必要な UI オートメーション ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI オートメーションの要件は、UI フレームワーク/プラットフォームがコントロールの種類とコントロール パターンに対する UI オートメーションのサポートを統合するすべてのイメージ コントロールに適用されます。
このトピックには、次のセクションが含まれています。
- 一般的なツリー構造の
- 関連するプロパティ を する
- 必要なコントロール パターンの
- 必要なイベント を する
- 関連トピック
一般的なツリー構造
次の表は、イメージ コントロールに関連する UI オートメーション ツリーの一般的なコントロールとコンテンツ ビューを示し、各ビューに含めることができる内容を示しています。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
| コントロール ビュー | コンテンツ ビュー |
|---|---|
| 画像 | イメージ (Automation 要素プロパティ識別子 プロパティの値に基づいて、イメージに情報が含まれているかどうかによって異なります) |
関連するプロパティ
次の表に、画像コントロールに特に関連する値または定義を持つ UI オートメーション プロパティを示します。 UI オートメーション プロパティの詳細については、「UI オートメーション要素からプロパティを取得する」を参照してください。
| UI オートメーション プロパティ | 価値 | 筆記 |
|---|---|---|
| UIA_AutomationIdPropertyId | ノートを参照してください。 | このプロパティの値は、UI オートメーション ツリーの生ビュー内のすべてのピア要素で一意である必要があります。 |
| UIA_BoundingRectanglePropertyId | ノートを参照してください。 | コントロール全体を含む最も外側の四角形。 |
| UIA_ClickablePointPropertyId | ノートを参照してください。 | イメージ コントロールのクリック可能なポイントは、イメージ コントロールの外接する四角形内のポイントである必要があります。 |
| UIA_ControlTypePropertyId | イメージ | |
| UIA_HelpTextPropertyId | ノートを参照してください。 | HelpText プロパティは、イメージに関連付けられたコントロールまたはその他のツールヒント情報の実際の外観を記述するローカライズされた文字列を公開します。 このプロパティは、画像コントロールに関する詳細情報を伝えるために長い説明が必要な場合にサポートする必要があります (たとえば、画像が複雑なグラフや図の場合)。 このプロパティは、HTML LongDesc タグと Scalable Vector Graphics (SVG) Desc タグにマップされます。 イメージ コントロールを使用する開発者は、コントロールに視覚的な説明を設定できるようにするプロパティをサポートする必要があります。 このプロパティは、VisualDescription プロパティ UI オートメーションにマップする必要があります。 |
| UIA_IsContentElementPropertyId | ノートを参照してください。 | エンド ユーザーにまだ公開されていない意味のある情報が含まれている場合は、UI オートメーション ツリーのコンテンツ ビューにイメージ コントロールを含める必要があります。 |
| UIA_IsControlElementPropertyId | 真 | イメージ コントロールは、常に UI オートメーション ツリーのコントロール ビューに含まれます。 |
| UIA_IsKeyboardFocusablePropertyId | ノートを参照してください。 | コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
| UIA_ItemStatusPropertyId | ノートを参照してください。 | 画像コントロールが画面上の特定の項目に関する状態情報を表す場合は、コントロールを項目内に含める必要があります。 イメージがアイテム内に含まれている場合、アイテムは status プロパティをサポートし、状態が変化したときに適切な通知を生成する必要があります。 イメージがスタンドアロン コントロールであり、状態を伝達している場合は、このプロパティをサポートする必要があります。 |
| UIA_LabeledByPropertyId | ノートを参照してください。 | 静的なテキスト ラベルがある場合、このプロパティは、そのコントロールへの参照を公開する必要があります。 |
| UIA_LocalizedControlTypePropertyId | ノートを参照してください。 | Image コントロール型に対応するローカライズされた文字列。 既定値は、en-US または英語 (米国) の場合は "image" です。 |
| UIA_NamePropertyId | ノートを参照してください。 | Name プロパティは、情報を含むすべてのイメージ コントロールに対して公開する必要があります。 この情報にプログラムでアクセスするには、グラフィックと同等のテキストを提供する必要があります。 イメージ コントロールが純粋に装飾されている場合は、UI オートメーション ツリーのコントロール ビューにのみ表示する必要があり、名前を付ける必要はありません (解説を参照)。 UI フレームワークでは、フレームワーク内から設定できるイメージの ALT または代替テキスト プロパティをサポートする必要があります。 このプロパティは、UI オートメーション名プロパティにマップされます。 |
必要なコントロール パターン
次の表に、イメージ コントロールでサポートする必要がある UI オートメーション コントロール パターンを示します。 コントロール パターンの詳細については、「UI オートメーション コントロール パターンの概要」を参照してください。
| コントロール パターン | 支える | 筆記 |
|---|---|---|
| IGridItemProviderの | 依存 | イメージ コントロールは、コントロールがグリッド コンテナー内にある場合に、GridItem コントロール パターンをサポートします。 |
| IInvokeProviderの | 一度もない | イメージ コントロールがクリック可能なオブジェクトの場合、コントロールは、Button コントロール型など、呼び出し コントロール パターンをサポートするコントロール型をサポートする必要があります。 複数のクリック可能なオブジェクトを含むイメージ オブジェクトの場合、要素 (イメージ コントロールの種類) は、UI オートメーション ツリーで子リンク (Hyperlink コントロール型) をホストできます。 |
| ISelectionItemProviderの | 一度もない | イメージ コントロールは、SelectionItem コントロール パターンをサポートしないでください。 イメージが、コンテンツとしてイメージ アイコンを持つボタンなど、選択可能なコンテナーの一部である場合、そのコンテナーは、その中のイメージではなく、パターンをサポートします。 |
| ITableItemProviderの | 依存 | イメージ コントロールは、コントロールがヘッダー コントロールを持つコンテナー内にある場合、TableItem コントロール パターンをサポートします。 |
必要なイベント
次の表に、イメージ コントロールがサポートするために必要な UI オートメーション イベントを示します。 イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。
| UI オートメーション イベント | 筆記 |
|---|---|
| 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 プロパティに値が含まれている場合と含まれていない場合
- 画像の意味も伝えるテキストは、コンテンツ ビューに含まれている必要があります。
- 画像が有益であり、関連するテキストによって提供されない詳細を伝える場合、画像は次のようになります。
- 未加工のビューに存在する必要があります
- コントロール ビューに存在する必要があります
- コンテンツ ビューに存在する必要があります
- イメージとその意味を説明する名前値が必要です