次の方法で共有

TitleBar コントロールの種類

  • [アーティクル]

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

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

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

一般的なツリー構造

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

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

 

関連するプロパティ

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

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

 

必要なコントロール パターン

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

必要なイベント

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

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

 

概念

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

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