UI オートメーションによる TitleBar コントロール型のサポート

更新 : 2007 年 11 月

ここでは、UI オートメーションによる TitleBar コントロール型のサポートに関する情報を示します。UI オートメーションでは、コントロール型は、ControlTypeProperty プロパティを使用するためにコントロールで満たす必要がある一連の条件となります。これらの条件には、UI オートメーション ツリー構造、UI オートメーションのプロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。

タイトル バー コントロールは、ウィンドウ内のタイトルまたはキャプション バーを表します。

以下のセクションでは、TitleBar コントロール型で必要な UI オートメーション ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。UI オートメーションの各要件は、Windows Presentation Foundation (WPF)、Win32、Windows フォームのいずれの場合でも、すべてのタイトル バー コントロールに当てはまります。

このトピックには次のセクションが含まれています。

• 必須の UI オートメーション ツリー構造
• 必須の UI オートメーション プロパティ
• 必須の UI オートメーション コントロール パターン
• 必須の UI オートメーション イベント
• 関連トピック

必須の UI オートメーション ツリー構造

次の表では、タイトル バー コントロールに関連する UI オートメーション ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに何を格納できるかについて説明します。UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。

コントロール ビュー	コンテンツ ビュー
TitleBar メニュー (1) ボタン (0 以上)	TitleBar コントロールは、コンテンツを格納しません。

必須の UI オートメーション プロパティ

次の表に、値または定義が特にタイトル バー コントロールに関連する UI オートメーションプロパティを示します。UI オートメーション プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。

UI オートメーションプロパティ	値	説明
AutomationIdProperty	説明を参照。	このプロパティの値は、アプリケーションのすべてのコントロールで一意にする必要があります。
BoundingRectangleProperty	メモを参照。	タイトル バーの外接する四角形は、タイトル バーに含まれるすべてのコントロールを囲んでいる必要があります。
ClickablePointProperty	説明を参照。	外接する四角形が存在する場合はサポートされます。外接する四角形の範囲内にクリック不可能な点が存在するときに特別なヒット テストを実行する場合は、クリック可能な点をオーバーライドして提供します。
IsKeyboardFocusableProperty	False	タイトル バーは、キーボード フォーカスを持つことはありません。
NameProperty	""	タイトル バーはコンテンツではありません。タイトル バーのテキスト情報は、親ウィンドウで公開されます。
LabeledByProperty	メモを参照。	通常、タイトル バー コントロールにはラベルはありません。
ControlTypeProperty	TitleBar	この値は、すべての UI フレームワークで共通です。
LocalizedControlTypeProperty	"タイトル バー"	タイトル バー コントロール型に対応するローカライズされた文字列。
IsContentElementProperty	False	タイトル バー コントロールはコンテンツではありません。
IsControlElementProperty	True	タイトル バー コントロールは、常にコントロールである必要があります。
IsOffscreenProperty	依存	このコントロールは、タイトル バーが画面上に表示されているかどうかに応じた値を返します。
HelpTextProperty	""	ヘルプ テキストを公開する必要はありません。
AcceleratorKeyProperty	""	タイトル バーは、アクセラレータ キーを持つことはありません。
AccessKeyProperty	""	タイトル バー コントロールにはアクセス キーはありません。

必須の UI オートメーション コントロール パターン

TitleBar コントロール型は、どのコントロール パターンもサポートする必要はありません。タイトル バーの機能は、ウィンドウ コントロールの Window コントロール パターンを通して公開されます。

必須の UI オートメーション イベント

すべてのタイトル バー コントロールでサポートする必要がある UI オートメーションイベントを次の表に示します。イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。

UI オートメーションイベント	サポート	説明
BoundingRectangleProperty プロパティ変更イベント。	必須	なし
IsOffscreenProperty プロパティ変更イベント。	必須	なし
IsEnabledProperty プロパティ変更イベント。	Never	なし
AutomationFocusChangedEvent	Never	なし
StructureChangedEvent	必須	なし

参照

概念

UI オートメーション コントロール型の概要

UI オートメーションの概要

参照

TitleBar