注
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージド UI オートメーション クラスを使用する .NET Framework 開発者を対象としています。 UI オートメーションの最新情報については、「Windows Automation API: UI オートメーション 」を参照してください。
このトピックでは、イメージ コントロールの種類に対する UI オートメーションのサポートについて説明します。 UI オートメーションでは、コントロール型は、 ControlTypeProperty プロパティを使用するためにコントロールが満たす必要がある一連の条件です。 条件には、UI オートメーション ツリー構造、UI オートメーション プロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。
アイコン、情報グラフィック、およびグラフとして使用されるイメージ コントロールは、イメージ コントロールの種類をサポートします。 背景または透かしの画像として使用されるコントロールでは、イメージ コントロールの種類はサポートされません。
次のセクションでは、Image コントロール型に必要な UI オートメーション ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI オートメーションの要件は、Windows Presentation Foundation (WPF)、Win32、Windows フォームのいずれであっても、すべてのイメージ コントロールに適用されます。
必要な UI オートメーション ツリー構造
次の表は、イメージ コントロールに関連する UI オートメーション ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに含めることができる内容を示しています。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
| コントロール ビュー | コンテンツ ビュー |
|---|---|
| 画像 | イメージ (イメージに情報が含まれているかどうかによって異なります ( IsContentElement プロパティの値に基づく) |
必要な UI オートメーション プロパティ
次の表に、値または定義が Image コントロール型に特に関連する UI オートメーション プロパティの一覧を示します。 UI オートメーション プロパティの詳細については、「 クライアントの UI オートメーション プロパティ」を参照してください。
| UI オートメーション プロパティ | 価値 | 注記 |
|---|---|---|
| AutomationIdProperty | ノートを参照してください。 | このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。 |
| BoundingRectangleProperty | ノートを参照してください。 | コントロール全体を含む最も外側の四角形。 |
| ClickablePointProperty | ノートを参照してください。 | イメージ コントロールのクリック可能なポイントは、イメージ コントロールの外接する四角形内のポイントである必要があります。 |
| IsKeyboardFocusableProperty | ノートを参照してください。 | コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
| NameProperty | ノートを参照してください。 | Name プロパティは、情報を含むすべてのイメージ コントロールに対して公開する必要があります。 この情報にプログラムでアクセスするには、グラフィックと同等のテキストを提供する必要があります。 イメージ コントロールが純粋に装飾されている場合は、UI オートメーション ツリーのコントロール ビューにのみ表示する必要があり、名前を付ける必要はありません。 UI フレームワークでは、フレームワーク内から設定できるイメージの ALT または代替テキスト プロパティをサポートする必要があります。 このプロパティは、UI オートメーション名プロパティにマップされます。 |
| LabeledByProperty | ノートを参照してください。 | 静的なテキスト ラベルがある場合、このプロパティはそのコントロールへの参照を公開する必要があります。 |
| ControlTypeProperty | 画像 | この値は、すべての UI フレームワークで同じです。 |
| LocalizedControlTypeProperty | "image" | Image コントロール型に対応するローカライズされた文字列。 |
| IsContentElementProperty | ノートを参照してください。 | エンド ユーザーにまだ公開されていない意味のある情報が含まれている場合は、UI オートメーション ツリーのコンテンツ ビューにイメージ コントロールを含める必要があります。 |
| IsControlElementProperty | 正しい | イメージ コントロールは、常に UI オートメーション ツリーのコントロール ビューに含まれます。 |
| HelpTextProperty | ノートを参照してください。 | HelpText プロパティは、コントロールの実際の外観 (白い "X" を持つ赤い四角形など) や画像に関連付けられているその他のヒント情報を記述するローカライズされた文字列を公開します。 イメージ コントロールに関する詳細情報を伝えるために長い説明が必要な場合は、このプロパティをサポートする必要があります。 たとえば、複雑なグラフや図などです。 このプロパティは、HTML LongDesc タグとスケーラブル ベクター グラフィックス (SVG) Desc タグにマップされます。 イメージ コントロールを使用する開発者は、コントロールに視覚的な説明を設定できるようにするプロパティをサポートする必要があります。 このプロパティは、UI オートメーション VisualDescription プロパティにマップする必要があります。 |
| ItemStatusProperty | ノートを参照してください。 | 画像コントロールが画面上の特定の項目に関する状態情報を表す場合は、コントロールを項目内に含める必要があります。 アイテム内にイメージが含まれている場合、アイテムは status プロパティをサポートし、状態が変化したときに適切な通知を生成する必要があります。 イメージがスタンドアロン コントロールであり、状態を伝達している場合は、このプロパティをサポートする必要があります。 |
必要な UI オートメーション コントロール パターン
次の表に、すべてのイメージ コントロールでサポートするために必要な UI オートメーション コントロール パターンを示します。 コントロール パターンの詳細については、「 UI オートメーション コントロール パターンの概要」を参照してください。
| コントロール パターン | 支援 | 注記 |
|---|---|---|
| IGridItemProvider | 依存 | コントロールがグリッド コンテナー内にある場合、イメージ コントロールはグリッド項目パターンをサポートします。 |
| ITableItemProvider | 依存 | コントロールがヘッダー コントロールを持つコンテナー内にある場合、イメージ コントロールはテーブル項目パターンをサポートします。 |
| IInvokeProvider | 決してない | イメージ コントロールにクリック可能なイメージが含まれている場合、コントロールは、Button コントロール型などの Invoke パターンをサポートするコントロール型をサポートする必要があります。 |
| ISelectionItemProvider | 決してない | イメージ コントロールは、選択項目パターンをサポートしないようにする必要があります。 |
必要な UI オートメーション イベント
次の表に、すべてのイメージ コントロールでサポートされる必要がある UI オートメーション イベントの一覧を示します。 イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。
| UI オートメーション イベント | 支援 | 注記 |
|---|---|---|
| InvokedEvent | 決してない | 無し |
| ElementAddedToSelectionEvent | 決してない | 無し |
| ElementRemovedFromSelectionEvent | 決してない | 無し |
| ElementSelectedEvent | 決してない | 無し |
| BoundingRectangleProperty プロパティ変更イベント。 | 必須 | 無し |
| IsOffscreenProperty プロパティ変更イベント。 | 必須 | 無し |
| IsEnabledProperty プロパティ変更イベント。 | 必須 | 無し |
| NameProperty プロパティ変更イベント。 | 必須 | 無し |
| AutomationFocusChangedEvent | 必須 | 無し |
| StructureChangedEvent | 必須 | 無し |