UI オートメーションによる Image コントロール型のサポート

  • [アーティクル]

Note

このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージド UI オートメーション クラスを使用する .NET Framework 開発者を対象としています。 UI オートメーションの最新情報については、Windows Automation API の「UI オートメーション」を参照してください。

このトピックでは、Image コントロール型に対する UI オートメーションのサポートについて説明します。 UI オートメーションでのコントロール型とは、コントロールで ControlTypeProperty プロパティを使用するために満たす必要がある条件のセットのことです。 この条件には、UI オートメーション ツリーの構造、UI オートメーションのプロパティ値、コントロール パターンに関する特定のガイドラインが含まれます。

アイコン、情報のグラフィック、チャートとして使用されるイメージ コントロールは、Image コントロール型をサポートします。 背景、またはウォーターマークのイメージとして使用されるコントロールは、Image コントロール型をサポートしません。

以降のセクションでは、Image コントロール型に必要な UI オートメーション ツリー構造、プロパティ、コントロール パターン、イベントを定義します。 この UI オートメーションの要件は、Windows Presentation Foundation (WPF)、Win32、または Windows フォームのいずれにおいても、すべてのイメージ コントロールに適用されます。

必須の UI オートメーション ツリー構造

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

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

必須の UI オートメーション プロパティ

次の表に、Image コントロール型に特に関連する値または定義を持つ UI オートメーション プロパティを示します。 UI オートメーション プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。

UI Automation のプロパティ 値 Notes
AutomationIdProperty 「ノート」を参照してください。 このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。
BoundingRectangleProperty 「ノート」を参照してください。 コントロール全体を格納する最も外側の四角形。
ClickablePointProperty 「ノート」を参照してください。 イメージ コントロールのクリック可能なポイントは、イメージ コントロールの四角形領域内のポイントである必要があります。
IsKeyboardFocusableProperty 「ノート」を参照してください。 コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。
NameProperty 「ノート」を参照してください。 情報が含まれているイメージ コントロールはすべて、Name プロパティが公開される必要があります。 この情報にプログラムでアクセスするには、グラフィックと等価なテキストを指定する必要があります。 イメージ コントロールが純粋な装飾の場合は、UI オートメーション ツリーのコントロール ビューにのみ表示される必要があり、名前を付ける必要はありません。 UI フレームワークは、イメージ上の ALT (代替テキスト) プロパティをサポートする必要があります。これはそのフレームワークの内部から設定できます。 次いで、このプロパティは、UI オートメーションの Name プロパティにマップされます。
LabeledByProperty 「ノート」を参照してください。 静的なテキスト ラベルがある場合、このプロパティは対象のコントロールへの参照を公開する必要があります。
ControlTypeProperty Image この値は、すべての UI フレームワークで同じです。
LocalizedControlTypeProperty "image" Image コントロール型に対応する、ローカライズされた文字列。
IsContentElementProperty 「ノート」を参照してください。 エンド ユーザーに対してまだ公開されていない有用な情報がイメージ コントロールに含まれている場合は、それを UI オートメーション ツリーのコンテンツ ビューに含める必要があります。
IsControlElementProperty True イメージ コントロールは、UI オートメーション ツリーのコントロール ビューに常に含まれます。
HelpTextProperty 「ノート」を参照してください。 HelpText プロパティは、コントロールの実際の外見 (白い 'X' が記された赤い四角形など) を説明するローカライズされた文字列や、イメージに関連する他のヒント情報を公開します。

イメージ コントロールについてより詳しい情報を示すために長い説明が必要な場合は、このプロパティをサポートする必要があります。 たとえば、複雑なチャートや図などです。 このプロパティは、HTML の LongDesc タグとスケーラブル ベクター グラフィックス (SVG) の Desc タグにマップされます。 イメージ コントロールを使用する開発者は、コントロールに視覚的な説明を設定できるようにするために、プロパティをサポートする必要があります。 このプロパティは、UI Automation VisualDescription プロパティにマップされる必要があります。
ItemStatusProperty 「ノート」を参照してください。 イメージ コントロールが画面上の特定の項目に関する状態情報を表している場合は、そのコントロールを対象の項目に含める必要があります。 ある項目の中にイメージが含まれている場合、その項目は状態プロパティをサポートし、状態が変わったときに適切な通知を発生させる必要があります。

イメージがスタンドアロン コントロールであり、状態を示している場合は、このプロパティをサポートする必要があります。

必須の UI オートメーション コントロール パターン

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

コントロール パターン サポート Notes
IGridItemProvider 依存 イメージ コントロールは、コントロールがグリッドのコンテナー内にある場合、Grid Item パターンをサポートします。
ITableItemProvider 依存 イメージ コントロールは、コントロールがヘッダー コントロールを持つコンテナー内にある場合、Table Item パターンをサポートします。
IInvokeProvider 行わない イメージ コントロールにクリック可能なイメージが含まれている場合、コントロールは、Invoke パターン (ボタン コントロール型など) をサポートしているコントロール型をサポートする必要があります。
ISelectionItemProvider 行わない イメージ コントロールは、Selection Item パターンをサポートしてはなりません。

必須の UI オートメーション イベント

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

UI オートメーション イベント サポート Notes
InvokedEvent なし なし
ElementAddedToSelectionEvent なし なし
ElementRemovedFromSelectionEvent なし なし
ElementSelectedEvent なし なし
BoundingRectangleProperty プロパティ変更イベント。 必須 なし
IsOffscreenProperty プロパティ変更イベント。 必須 なし
IsEnabledProperty プロパティ変更イベント。 必須 なし
NameProperty プロパティ変更イベント。 必須 なし
AutomationFocusChangedEvent 必須 なし
StructureChangedEvent 必須 なし

関連項目