AppBar コントロールの種類

  • [アーティクル]

このトピックでは、AppBar コントロールの種類に対する Microsoft UI オートメーション のサポートについて説明します。

アプリ バーは、ナビゲーション、コマンド、ツールをユーザーに提示する UI 要素です。 Windows ストア アプリの場合は、Windows キーを押しながら Z キーを押すと、アプリのアプリ バーを表示できます。

次のセクションでは、AppBar コントロール型に必要なUI オートメーションツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。

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

一般的なツリー構造

次の表は、AppBar コントロールに関連するUI オートメーション ツリーの一般的なコントロールとコンテンツ ビューを示し、各ビューに含めることができる内容について説明します。 Button は AppBar 内で最も一般的な要素ですが、アプリのアクションを呼び出す他のコントロールも可能です。 AppBar には、他のコントロールの間に配置されたコントロール ビューに表示される 0 個以上の区切り記号 (区切り記号コントロールの種類) を含めることもできます。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。

コントロール ビュー コンテンツ ビュー
  • AppBar
    • Button (0 以上)
    • その他のコントロール (0 個以上)
  • 適用できません
    • Button (0 以上)
    • その他のコントロール (0 個以上)

 

関連するプロパティ

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

UI Automation のプロパティ 値 メモ
UIA_AutomationIdPropertyId 「ノート」を参照してください。 このプロパティの値は、UI オートメーション ツリーの生ビュー内のすべてのピア要素間で一意である必要があります。
UIA_BoundingRectanglePropertyId 「ノート」を参照してください。 このプロパティで公開する値には、メニュー バー コントロールに含まれるすべてのコントロールを含める必要があります。
UIA_ControlTypePropertyId AppBar
UIA_IsContentElementPropertyId FALSE アプリ バー コントロールは、UI オートメーション ツリーのコンテンツ ビューには含まれません。
UIA_IsControlElementPropertyId true アプリ バー コントロールは、常にUI オートメーション ツリーのコントロール ビューに含まれます。
UIA_IsKeyboardFocusablePropertyId メモを参照 コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 アプリ バー内のコントロールは、通常、キーボードフォーカスを取ることができます。
UIA_IsOffscreenPropertyId 「ノート」を参照してください。 このプロパティの値は、コントロールを画面に表示できるかどうかによって異なります。
UIA_LabeledByPropertyId [Null] 通常、アプリ バー コントロールにはラベルがありません。
UIA_LocalizedControlTypePropertyId 「ノート」を参照してください。 AppBar コントロールの種類に対応するローカライズされた文字列。 既定値は、en-US または英語 (米国) の "アプリ バー" です。
UIA_NamePropertyId 「ノート」を参照してください。 アプリケーションに複数のアプリ バーがない限り、アプリ バー コントロールには名前は必要ありません。 アプリケーションに複数のアプリ バーがある場合は、このプロパティを使用して、"Top" や "Bottom" などの識別名を公開します。

 

必須イベント

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

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

 

関連するイベント

次の表に、AppBar コントロール型を実装するが厳密には必要ではないコントロールに特に関連するUI オートメーション イベントを示します。

UI オートメーション イベント メモ
UIA_MenuClosedEventId プラットフォームの実装では、アプリ バー コントロールが閉じられたときにこのイベントが発生する可能性があります。
UIA_MenuOpenedEventId プラットフォームの実装では、アプリ バー コントロールを開いたときにこのイベントが発生する可能性があります。
IUIAutomationPropertyChangedEventHandler プロパティ変更イベント ハンドラー。

 

概念

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

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

参照

AppBar XAML コントロール

WinJS.UI.AppBar オブジェクト