TitleBar コントロールの種類

  • [アーティクル]

このトピックでは、TitleBar コントロール型の Microsoft UI オートメーション サポートについて説明します。 タイトル バー コントロールは、ウィンドウ内のタイトルまたはキャプション バーを表します。

次のセクションでは、TitleBar コントロール型に必要なUI オートメーションツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI オートメーションの要件は、UI フレームワーク/プラットフォームがコントロールの種類とコントロール パターンのサポートUI オートメーション統合するすべてのタイトル バー コントロールに適用されます。

このトピックは、次のセクションで構成されています。

一般的なツリー構造

次の表は、タイトル バー コントロールに関連するUI オートメーション ツリーの一般的なコントロールとコンテンツ ビューを示し、各ビューに含めることができる内容について説明します。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。

コントロール ビュー コンテンツ ビュー
  • TitleBar
    • Menu (0 または 1)
    • Button (0 以上)
 (適用できません。タイトル バー コントロールにはコンテンツがありません)

 

関連するプロパティ

次の表に、値または定義が TitleBar コントロール型に特に関連するUI オートメーションプロパティの一覧を示します。 UI オートメーションプロパティの詳細については、「UI オートメーション要素からのプロパティの取得」を参照してください。

UI Automation のプロパティ 値 Notes
UIA_AutomationIdPropertyId 「ノート」を参照してください。 このプロパティの値は、UI オートメーション ツリーの生ビュー内のすべてのピア要素間で一意である必要があります。
UIA_BoundingRectanglePropertyId 「ノート」を参照してください。 このプロパティで公開する値には、メニュー バー コントロールに含まれるすべてのコントロールを含める必要があります。
UIA_ClickablePointPropertyId 「ノート」を参照してください。 四角形領域が存在する場合にサポートされます。 外接する四角形内のすべてのポイントがクリック可能でなく、要素が特殊なヒット テストを実行する場合は、オーバーライドしてクリック可能なポイントを指定します。
UIA_ControlTypePropertyId TitleBar この値は、すべての UI フレームワークで同じです。
UIA_IsContentElementPropertyId FALSE タイトル バー コントロールは、UI オートメーション ツリーのコンテンツ ビューには含まれません。
UIA_IsControlElementPropertyId true タイトル バー コントロールは、常にUI オートメーション ツリーのコントロール ビューに含まれます。
UIA_IsKeyboardFocusablePropertyId FALSE タイトル バー コントロールにキーボード フォーカスが設定されることはありません。
UIA_IsOffscreenPropertyId 依存 タイトル バー コントロールは、画面に表示されているかどうかに応じて値を返します。
UIA_LabeledByPropertyId 「ノート」を参照してください。 通常、タイトル バー コントロールにはラベルがありません。
UIA_LocalizedControlTypePropertyId 「ノート」を参照してください。 TitleBar コントロール型に対応する、ローカライズされた文字列。 既定値は、en-US または英語 (米国) の "タイトル バー" です。
UIA_NamePropertyId "" タイトル バーはコンテンツではありません。そのテキスト情報は、親ウィンドウの名前によって公開されます。

 

必須のコントロール パターン

TitleBar コントロールの種類は、コントロール パターンをサポートするために必要ありません。 その機能は、Window コントロール型の Window コントロール パターンを通 じて公開されます。

必須イベント

次の表に、タイトル バー コントロールがサポートするために必要なUI オートメーション イベントの一覧を示します。 イベントの詳細については、「 UI Automation Events Overview」を参照してください。

UI オートメーション イベント Notes
UIA_AutomationFocusChangedEventId
プロパティ変更イベントUIA_BoundingRectanglePropertyId 。
プロパティ変更イベントUIA_IsEnabledPropertyId。 コントロールが IsEnabled プロパティをサポートしている場合は、このイベントをサポートする必要があります。
プロパティ変更イベントUIA_IsOffscreenPropertyId。 コントロールが IsOffscreen プロパティをサポートしている場合は、このイベントをサポートする必要があります。
UIA_StructureChangedEventId

 

概念

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

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