UI オートメーションによる TreeItem コントロール型のサポート
.gif "メモ") メモ |
|---|
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージ UI Automation クラスを使用する .NET Framework 開発者を対象としています。UI Automationに関する最新情報については、「Windows Automation API: UI Automation (Windows オートメーション API: UI オートメーション)」を参照してください。 |
ここでは、UI Automationによる TreeItem コントロール型のサポートに関する情報を示します。 UI Automationでは、コントロール型は、ControlTypeProperty プロパティを使用するためにコントロールで満たす必要がある一連の条件となります。 これらの条件には、UI Automation ツリー構造、UI Automationのプロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。
TreeItem コントロール型は、ツリー コンテナー内のノードを表します。 各ノードには、子ノードと呼ばれる他のノードを含めることができます。 親ノード (子ノードを含むノード) は、展開した状態または折りたたんだ状態で表示できます。
以下のセクションでは、TreeItem コントロール型で必要な UI Automation ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI Automationの各要件は、Windows Presentation Foundation (WPF)、Win32、Windows Formsのいずれの場合でも、すべてのツリー項目コントロールに当てはまります。
このトピックは、次のセクションで構成されています。
- 必須の UI オートメーション ツリー構造
- 必須の UI オートメーション プロパティ
- 必須の UI オートメーション コントロール パターン
- 必須の UI オートメーション イベント
- 関連トピック
必須の UI オートメーション ツリー構造
次の表では、ツリー項目コントロールに関連する UI Automation ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに格納できるものについて説明します。 UI Automation ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
コントロール ビュー |
コンテンツ ビュー |
|---|---|
TreeItem
|
TreeItem
|
ツリー項目コントロールは、UI Automationツリーのコンテンツ ビュー内に 0 以上のツリー項目の子を持つことができます。 ツリー項目コントロールの機能が後述のコントロール パターンで公開される機能を越える場合、そのコントロールはデータ項目コントロール型に基づきます。
折りたたまれたツリー項目は、展開され表示される (またはスクロールされ表示される) までコントロール ビューまたはコンテンツ ビューに表示されません。
コントロール ビューには、関連付けられたイメージやボタンなど、コントロールの詳細を含めることができます。 たとえば、アウトライン表示の項目にボタンだけでなくイメージを含めて、アウトラインを展開したり折りたたんだりできます。 情報は既に親ツリー項目で表されているため、これらの詳細オブジェクトはコンテンツ ビューには表示されません。 スクロールして画面から外れたツリー項目は、UI Automationツリーのコントロール ビューとコンテンツ ビューの両方に表示され、IsOffscreenProperty が true に設定される必要があります。
必須の UI オートメーション プロパティ
値または定義がリスト コントロールに特に関連する UI Automationのプロパティの一覧を次の表に示します。 UI Automation プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。
UI Automation プロパティ |
値 |
説明 |
|---|---|---|
説明を参照。 |
このプロパティの値は、アプリケーションのすべてのコントロールで一意にする必要があります。 |
|
説明を参照。 |
コントロール全体を包含する外側の四角形。 |
|
説明を参照。 |
このプロパティは、項目の選択状態が変更される場所、または項目がフォーカスを受け取る場所を返す必要があります。 |
|
TreeItem |
この値は、すべての UI フレームワークで共通です。 |
|
True |
リスト コントロールは、常に UI Automationツリーのコンテンツ ビューに含まれます。 |
|
True |
リスト コントロールは、常に UI Automationツリーのコントロール ビューに含まれます。 |
|
説明を参照。 |
このプロパティは、ツリー項目コントロールがスクロールされて画面から外れるタイミングを示すために設定します。 |
|
説明を参照。 |
コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
|
説明を参照。 |
ツリー項目コントロールがオブジェクトの特定の型であるビジュアル アイコンを使用して表されている場合は、このプロパティをサポートして、オブジェクトの型を示す必要があります。 |
|
Null |
ツリー項目コントロールは、自動的にラベルが付けられます。 |
|
"ツリー項目" |
TreeItem コントロール型に対応するローカライズされた文字列。 |
|
説明を参照。 |
このプロパティは、ツリー項目コントロールごとに表示されるテキストを公開します。 |
必須の UI オートメーション コントロール パターン
リスト コントロールでサポートする必要がある UI Automation コントロール パターンの一覧を次の表に示します。 コントロール パターンの詳細については、「UI オートメーション コントロール パターンの概要」を参照してください。
コントロール パターン/パターン プロパティ |
サポート/値 |
説明 |
|---|---|---|
依存 |
ツリー項目に個別のアクション可能なコマンドがある場合は、このコントロール パターンを実装します。 |
|
○ |
ツリー項目はすべて展開または折りたたむことができます。 |
|
展開表示、折りたたみ表示、またはリーフ ノード |
ツリー項目は、展開されていないとき、または折りたたまれていないときはリーフ ノードです。 |
|
依存 |
ツリー コンテナーが Scroll コントロール パターンをサポートする場合は、このコントロール パターンを実装します。 |
|
依存 |
ユーザーがツリー コンテナーに戻ったときに、維持されているアクティブな選択内容を使用できる場合は、このコントロール パターンを実装します。 |
|
○ |
このプロパティは、コンテナー内のすべての項目に対して同じコンテナーを公開します。 |
|
依存 |
ツリー項目に関連付けられたチェック ボックスがある場合は、このコントロール パターンを実装します。 |
必須の UI オートメーション イベント
すべてのツリー項目コントロールでサポートする必要がある UI Automationイベントを次の表に示します。 イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。
UI Automation イベント |
サポート |
説明 |
|---|---|---|
必須 |
なし |
|
BoundingRectangleProperty プロパティ変更イベント |
必須 |
なし |
IsEnabledProperty プロパティ変更イベント |
必須 |
なし |
IsOffscreenProperty プロパティ変更イベント |
必須 |
なし |
ItemStatusProperty プロパティ変更イベント |
依存 |
なし |
NameProperty プロパティ変更イベント |
必須 |
なし |
必須 |
なし |
|
ExpandCollapseStateProperty プロパティ変更イベント |
必須 |
なし |
依存 |
なし |
|
CurrentViewProperty プロパティ変更イベント |
依存 |
なし |
依存 |
なし |
|
依存 |
なし |
|
依存 |
なし |
|
ToggleStateProperty プロパティ変更イベント |
依存 |
なし |
ValueProperty プロパティ変更イベント |
依存 |
なし |