UI オートメーションによる TitleBar コントロール型のサポート
.gif "メモ") メモ |
|---|
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージ UI Automation クラスを使用する .NET Framework 開発者を対象としています。UI Automationに関する最新情報については、「Windows Automation API: UI Automation (Windows オートメーション API: UI オートメーション)」を参照してください。 |
ここでは、UI Automationによる TitleBar コントロール型のサポートに関する情報を示します。 UI Automationでは、コントロール型は、ControlTypeProperty プロパティを使用するためにコントロールで満たす必要がある一連の条件となります。 これらの条件には、UI Automation ツリー構造、UI Automationのプロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。
タイトル バー コントロールは、ウィンドウ内のタイトルまたはキャプション バーを表します。
以下のセクションでは、TitleBar コントロール型で必要な UI Automation ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI Automationの各要件は、Windows Presentation Foundation (WPF)、Win32、Windows Formsのいずれの場合でも、すべてのタイトル バー コントロールに当てはまります。
このトピックは、次のセクションで構成されています。
- 必須の UI オートメーション ツリー構造
- 必須の UI オートメーション プロパティ
- 必須の UI オートメーション コントロール パターン
- 必須の UI オートメーション イベント
- 関連トピック
必須の UI オートメーション ツリー構造
次の表では、タイトル バー コントロールに関連する UI Automation ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに何を格納できるかについて説明します。 UI Automation ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
コントロール ビュー |
コンテンツ ビュー |
|---|---|
TitleBar
|
適用できません。 (タイトル バー コントロールにはコンテンツはありません)。 |
必須の UI オートメーション プロパティ
次の表に、値または定義が特にタイトル バー コントロールに関連する UI Automationプロパティを示します。 UI Automation プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。
UI Automation プロパティ |
値 |
説明 |
|---|---|---|
説明を参照。 |
このプロパティの値は、アプリケーションのすべてのコントロールで一意にする必要があります。 |
|
メモを参照。 |
タイトル バーの外接する四角形は、タイトル バーに含まれるすべてのコントロールを囲んでいる必要があります。 |
|
説明を参照。 |
外接する四角形が存在する場合はサポートされます。 外接する四角形の範囲内にクリック不可能な点が存在するときに特別なヒット テストを実行する場合は、クリック可能な点をオーバーライドして提供します。 |
|
False |
タイトル バーは、キーボード フォーカスを持つことはありません。 |
|
"" |
タイトル バーはコンテンツではありません。タイトル バーのテキスト情報は、親ウィンドウで公開されます。 |
|
メモを参照。 |
通常、タイトル バー コントロールにはラベルはありません。 |
|
TitleBar |
この値は、すべての UI フレームワークで共通です。 |
|
"タイトル バー" |
タイトル バー コントロール型に対応するローカライズされた文字列。 |
|
False |
タイトル バー コントロールはコンテンツではありません。 |
|
True |
タイトル バー コントロールは、常にコントロールである必要があります。 |
|
依存 |
このコントロールは、タイトル バーが画面上に表示されているかどうかに応じた値を返します。 |
|
"" |
ヘルプ テキストを公開する必要はありません。 |
|
"" |
タイトル バーは、アクセラレータ キーを持つことはありません。 |
|
"" |
タイトル バー コントロールにはアクセス キーはありません。 |
必須の UI オートメーション コントロール パターン
TitleBar コントロール型は、どのコントロール パターンもサポートする必要はありません。 タイトル バーの機能は、ウィンドウ コントロールの Window コントロール パターンを通して公開されます。
必須の UI オートメーション イベント
すべてのタイトル バー コントロールでサポートする必要がある UI Automationイベントを次の表に示します。 イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。
UI Automation イベント |
サポート |
説明 |
|---|---|---|
BoundingRectangleProperty プロパティ変更イベント |
必須 |
なし |
IsOffscreenProperty プロパティ変更イベント |
必須 |
なし |
IsEnabledProperty プロパティ変更イベント |
なし |
なし |
なし |
なし |
|
必須 |
なし |