UI オートメーションによる MenuBar コントロール型のサポート
.gif "メモ") メモ |
|---|
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージ UI Automation クラスを使用する .NET Framework 開発者を対象としています。UI Automationに関する最新情報については、「Windows Automation API: UI Automation (Windows オートメーション API: UI オートメーション)」を参照してください。 |
ここでは、UI Automationによる MenuBar コントロール型のサポートに関する情報を示します。 UI Automationでは、コントロール型は、ControlTypeProperty プロパティを使用するためにコントロールで満たす必要がある一連の条件となります。 これらの条件には、UI Automation ツリー構造、UI Automationのプロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。
MenuBar コントロール型を実装するコントロールとして、メニュー バー コントロールなどがあります。 メニュー バーが提供する手段によって、ユーザーは、アプリケーションに含まれているコマンドとオプションをアクティブ化することができます。
以下のセクションでは、MenuBar コントロール型の必須の UI Automation ツリー構造、プロパティ、コントロール パターン、およびイベントを示します。 UI Automationの各要件は、Windows Presentation Foundation (WPF)、Win32、Windows Forms のいずれの場合でも、すべてのリスト コントロールに当てはまります。
このトピックは、次のセクションで構成されています。
- 必須の UI オートメーション ツリー構造
- 必須の UI オートメーション プロパティ
- 必須の UI オートメーション コントロール パターン
- 必須の UI オートメーション イベント
- 関連トピック
必須の UI オートメーション ツリー構造
次の表では、メニュー バー コントロールに関連した UI Automation ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに格納できるものについて説明します。 UI Automation ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
コントロール ビュー |
コンテンツ ビュー |
|---|---|
MenuBar
|
MenuBar
|
メニュー バー コントロールは、エディット コントロールや構造内のコンボ ボックスなど他のコントロールを含むことができます。 この追加のコントロールは、上のコントロール ビューおよびコンテンツ ビュー内に示した "その他のコントロール" に該当します。
必須の UI オートメーション プロパティ
次の表に、値または定義が特にメニュー バー コントロールに関連する UI Automation プロパティを示します。 UI Automation プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。
UI Automation プロパティ |
値 |
説明 |
|---|---|---|
説明を参照。 |
このプロパティによって公開される値は、このプロパティに格納されているすべてのコントロールを含む必要があります。 |
|
説明を参照。 |
1 つのアプリケーションに複数のメニュー バーを持たせない限り、メニュー バーに名前を付ける必要はありません。 複数のメニュー バーを 1 つのアプリケーションに持たせる場合、このプロパティを使用して、"書式設定" や "アウトライン" など識別するための名前を公開する必要があります。 |
|
Null |
メニュー バー コントロールにはラベルはありません。 |
|
MenuBar |
この値は、すべての UI フレームワークで共通です。 |
|
"メニュー バー" |
MenuBar コントロール型に対応するローカライズされた文字列。 |
|
True |
メニュー バー コントロールは、常に UI Automation ツリーのコンテンツ ビューに含まれます。 |
|
True |
メニュー バー コントロールは、常に UI Automation ツリーのコントロール ビューに含まれます。 |
|
説明を参照。 |
このプロパティの値は、画面上にコントロールを表示できるかどうかによって決まります。 |
|
依存 |
このプロパティは、メニュー バー コントロールが水平方向であるか、垂直方向であるかを公開します。 |
|
True |
キーボード フォーカスを取得できるコントロールを含んでいるため、メニュー バー コントロールはキーボード フォーカスを受け取ることができます。 |
|
説明を参照。 |
メニュー バー コントロールにヘルプ テキストを必要とする場合のシナリオはありません。 |
|
Null |
メニュー バーにはアクセラレータ キーはありません。 |
|
"ALT" |
アプリケーション内で、Alt キーを押すと常にメニュー バーにフォーカスが移動します。 |
必須の UI オートメーション コントロール パターン
メニュー バー コントロールでサポートする必要がある UI Automation コントロール パターンの一覧を次の表に示します。 コントロール パターンの詳細については、「UI オートメーション コントロール パターンの概要」を参照してください。
コントロール パターン |
サポート |
説明 |
|---|---|---|
依存 |
コントロールを展開または折りたたむことができる場合は、IExpandCollapseProvider を実装します。 |
|
依存 |
コントロールを画面の別の部分にドッキングできる場合は、IDockProvider を実装します。 |
|
依存 |
コントロールのサイズ変更、回転、または移動を行うことができる場合は、ITransformProvider を実装する必要があります。 |
必須の UI オートメーション イベント
すべてのメニュー バー コントロールでサポートする必要がある UI Automation イベントを次の表に示します。 イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。
UI Automation イベント |
サポート/値 |
説明 |
|---|---|---|
BoundingRectangleProperty プロパティ変更イベント |
必須 |
なし |
IsOffscreenProperty プロパティ変更イベント |
必須 |
なし |
IsEnabledProperty プロパティ変更イベント |
必須 |
なし |
ExpandCollapseStateProperty プロパティ変更イベント |
依存 |
なし |
必須 |
なし |
|
必須 |
なし |