UI オートメーションによる ListItem コントロール型のサポート
更新 : 2007 年 11 月
ここでは、UI オートメーションによる ListItemコントロール型のサポートに関する情報を示します。UI オートメーションでは、コントロール型は、ControlTypeProperty プロパティを使用するためにコントロールで満たす必要がある一連の条件となります。これらの条件には、UI オートメーション ツリー構造、UI オートメーションのプロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。
ListItem コントロール型を実装するコントロールとして、リスト項目コントロールなどがあります。
以下のセクションでは、ListItem コントロール型で必要な UI オートメーション ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。UI オートメーションの各要件は、Windows Presentation Foundation (WPF)、Win32、Windows フォーム のいずれの場合でも、すべてのリスト コントロールに当てはまります。
このトピックには次のセクションが含まれています。
- 必須の UI オートメーション ツリー構造
- 必須の UI オートメーション プロパティ
- 必須の UI オートメーション コントロール パターン
- 必須の UI オートメーション イベント
- 関連トピック
必須の UI オートメーション ツリー構造
次の表では、リスト項目コントロールに関連する UI オートメーション ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに格納できるものについて説明します。UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
コントロール ビュー |
コンテンツ ビュー |
|---|---|
|
|
UI オートメーションツリーのコンテンツ ビュー内のリスト項目コントロールの子は、常に "0" である必要があります。リスト項目の下に他の項目が含まれるような構造を持つコントロールは、UI オートメーションによる TreeItem コントロール型のサポート コントロール型の要件に従う必要があります。
必須の UI オートメーション プロパティ
値または定義がリスト項目コントロールに特に関連する UI オートメーションのプロパティの一覧を次の表に示します。UI オートメーション プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。
UI オートメーション プロパティ |
値 |
説明 |
|---|---|---|
AutomationIdProperty() |
説明を参照。 |
このプロパティの値は、アプリケーションのすべてのコントロールで一意にする必要があります。 |
説明を参照。 |
このプロパティのこの値には、リスト項目のイメージおよびテキスト コンテンツの領域を含める必要があります。 |
|
依存 |
リスト コントロールにクリック可能なポイント (クリックするとリストがフォーカスを受け取るポイント) がある場合、そのポイントはこのプロパティを介して公開される必要があります。リスト コントロールが子孫のリスト項目に完全に覆われている場合、そのコントロールは、クリック可能なポイントをリスト コントロールの内側にある項目に対して要求する必要があることをクライアントに示すために、NoClickablePointException を発生させます。 |
|
説明を参照。 |
リスト項目コントロールの名前プロパティの値は、その項目のテキスト コンテンツから取得されます。 |
|
説明を参照。 |
静的テキスト ラベルが存在する場合、このプロパティは、該当するコントロールへの参照を公開する必要があります。 |
|
ListItem |
この値は、すべての UI フレームワークで共通です。 |
|
"リスト項目" |
ListItem コントロール型に対応するローカライズされた文字列。 |
|
True |
リスト コントロールは、常に UI オートメーションツリーのコンテンツ ビューに含まれます。 |
|
True |
リスト コントロールは、常に UI オートメーションツリーのコントロール ビューに含まれます。 |
|
True |
コンテナがキーボード入力を受け取ることができる場合、このプロパティ値は true である必要があります。 |
|
"" |
リスト コントロールのヘルプ テキストでは、オプションの一覧から選択することをユーザーに求めている理由を説明する必要があります。たとえば、"この一覧から項目を選択すると、モニタの表示解像度が設定されます" という説明を表示します。 |
|
依存 |
このプロパティは、基になるオブジェクトを表しているリスト項目コントロールに対して公開される必要があります。これらのリスト項目コントロールには、通常、ユーザーが基になるオブジェクトと関連付けたコントロールに関連付けられたアイコンがあります。 |
|
依存 |
このプロパティは、そのリスト項目が現在、スクロール コントロール パターンを実装した親コンテナ内でスクロールして表示されているかどうかを示す値を返す必要があります。 |
必須の UI オートメーション コントロール パターン
リスト項目コントロールでサポートする必要がある UI オートメーションコントロール パターンの一覧を次の表に示します。コントロール パターンの詳細については、「UI オートメーション コントロール パターンの概要」を参照してください。
コントロール パターン/パターン プロパティ |
サポート/値 |
説明 |
|---|---|---|
○ |
リスト項目コントロールには、このコントロール パターンを実装する必要があります。これにより、リスト項目コントロールは、選択されたことを伝達できます。 |
|
依存 |
このリスト項目がスクロール可能なコンテナに格納されている場合には、このコントロール パターンを実装する必要があります。 |
|
依存 |
このリスト項目がチェック可能で、アクションによって選択状態の変更が実行されない場合には、このコントロール パターンを実装する必要があります。 |
|
依存 |
この項目を操作して情報を表示または非表示にできる場合は、このコントロール パターンを実装する必要があります。 |
|
依存 |
この項目が編集可能である場合は、このコントロール パターンを実装する必要があります。このリスト項目コントロールを変更すると、NameProperty および Value の値が変更されます。 |
|
依存 |
リスト コンテナ内で項目間の空間的移動がサポートされており、コンテナが行と列に配置されている場合は、グリッド項目コントロール パターンを実装する必要があります。 |
|
依存 |
この項目に、この項目自体に対して実行できる選択以外のコマンドがある場合には、このパターンを実装する必要があります。これは通常、リスト項目コントロールのダブルクリックに関連付けられたアクションです。この例としては、Microsoft Windows エクスプローラからのドキュメントの起動や、Microsoft Windows Media Player での音楽ファイルの再生などがあります。 |
必須の UI オートメーション イベント
すべてのリスト項目コントロールでサポートする必要がある UI オートメーションイベントを次の表に示します。イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。
UI オートメーション イベント |
サポート |
説明 |
|---|---|---|
依存 |
なし |
|
必須 |
なし |
|
必須 |
なし |
|
必須 |
なし |
|
BoundingRectangleProperty プロパティ変更イベント。 |
必須 |
なし |
IsOffscreenProperty プロパティ変更イベント。 |
必須 |
なし |
IsEnabledProperty プロパティ変更イベント。 |
必須 |
なし |
必須 |
なし |
|
ItemStatusProperty プロパティ変更イベント。 |
依存 |
なし |
ExpandCollapseStateProperty プロパティ変更イベント。 |
依存 |
なし |
ValueProperty プロパティ変更イベント。 |
依存 |
なし |
ToggleStateProperty プロパティ変更イベント。 |
依存 |
なし |
必須 |
なし |
|
必須 |
なし |