AppBar コントロールの種類
このトピックでは、AppBar コントロールの種類に対する Microsoft UI オートメーション のサポートについて説明します。
アプリ バーは、ナビゲーション、コマンド、ツールをユーザーに提示する UI 要素です。 Windows ストア アプリの場合は、Windows キーを押しながら Z キーを押すと、アプリのアプリ バーを表示できます。
次のセクションでは、AppBar コントロール型に必要なUI オートメーションツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。
このトピックは、次のセクションで構成されています。
一般的なツリー構造
次の表は、AppBar コントロールに関連するUI オートメーション ツリーの一般的なコントロールとコンテンツ ビューを示し、各ビューに含めることができる内容について説明します。 Button は AppBar 内で最も一般的な要素ですが、アプリのアクションを呼び出す他のコントロールも可能です。 AppBar には、他のコントロールの間に配置されたコントロール ビューに表示される 0 個以上の区切り記号 (区切り記号コントロールの種類) を含めることもできます。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
コントロール ビュー | コンテンツ ビュー |
---|---|
|
|
関連するプロパティ
次の表に、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 | プロパティ変更イベント ハンドラー。 |
関連トピック