AppBar コントロールの種類
このトピックでは、AppBar コントロールの種類に対する Microsoft UI オートメーションのサポートについて説明します。
アプリ バーは、ユーザーにナビゲーション、コマンド、ツールを表示する UI 要素です。 Windows ストア アプリの場合、Windows キーを押しながら Z キーを押すと、アプリのアプリ バーを表示できます。
次のセクションでは、AppBar コントロール型に必要な UI オートメーション ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。
このトピックには、次のセクションが含まれています。
- 一般的なツリー構造の
- 関連するプロパティ を する
- 必要なイベント を する
- 関連イベント を する
- 関連トピック
一般的なツリー構造
次の表は、appBar コントロール に関連する UI オートメーション ツリーの一般的なコントロールとコンテンツ ビューを示し、各ビューに含めることができる内容について説明します。 Button は、AppBar 内で最も一般的な要素ですが、アプリのアクションを呼び出す他のコントロールも可能です。 AppBar には、0 個以上の区切り記号 (区切り コントロール型) を含めることもできます。この区切り記号は、他のコントロールの間に配置されたコントロール ビューに表示されます。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
| コントロール ビュー | コンテンツ ビュー |
|---|---|
|
|
関連するプロパティ
次の表に、AppBar コントロール型を実装するコントロールに特に関連する値または定義を持つ UI オートメーション プロパティの一覧を示します。 UI オートメーション プロパティの詳細については、「UI オートメーション要素からプロパティを取得する」を参照してください。
| UI オートメーション プロパティ | 価値 | 筆記 |
|---|---|---|
| UIA_AutomationIdPropertyId | ノートを参照してください。 | このプロパティの値は、UI オートメーション ツリーの生ビュー内のすべてのピア要素で一意である必要があります。 |
| UIA_BoundingRectanglePropertyId | ノートを参照してください。 | このプロパティによって公開される値には、その中に含まれるすべてのコントロールが含まれている必要があります。 |
| UIA_ControlTypePropertyId | AppBar | |
| UIA_IsContentElementPropertyId | 偽 | アプリ バー コントロールは、UI オートメーション ツリーのコンテンツ ビューには含まれません。 |
| UIA_IsControlElementPropertyId | 真 | アプリ バー コントロールは、常に UI オートメーション ツリーのコントロール ビューに含まれます。 |
| UIA_IsKeyboardFocusablePropertyId | ノートを参照する | コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 通常、アプリ バー内のコントロールはキーボード フォーカスを取得できます。 |
| UIA_IsOffscreenPropertyId | ノートを参照してください。 | このプロパティの値は、コントロールが画面上で表示可能かどうかによって異なります。 |
| UIA_LabeledByPropertyId | ヌル | 通常、アプリ バー コントロールにはラベルがありません。 |
| UIA_LocalizedControlTypePropertyId | ノートを参照してください。 | AppBar コントロール型に対応するローカライズされた文字列。 既定値は、en-US または英語 (米国) の "アプリ バー" です。 |
| UIA_NamePropertyId | ノートを参照してください。 | アプリケーションに複数のアプリ バーがない限り、アプリ バー コントロールには名前は必要ありません。 アプリケーションに複数のアプリ バーがある場合は、このプロパティを使用して、"Top" や "Bottom" などの識別名を公開します。 |
必要なイベント
次の表に、アプリ バー コントロールがサポートするために必要な UI オートメーション イベントの一覧を示します。 イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。
| UI オートメーション イベント | 筆記 |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| プロパティ変更イベント UIA_BoundingRectanglePropertyId します。 | |
| プロパティ変更イベントを UIA_IsEnabledPropertyId します。 | コントロールが IsEnabled プロパティをサポートしている場合は、このイベントをサポートする必要があります。 |
| プロパティ変更イベント UIA_IsOffscreenPropertyId します。 | コントロールが IsOffscreen プロパティをサポートしている場合は、このイベントをサポートする必要があります。 |
| UIA_StructureChangedEventId |
関連するイベント
次の表に、AppBar コントロール型を実装するコントロールに特に関連する UI オートメーション イベントを示しますが、厳密には必要ありません。
| UI オートメーション イベント | 筆記 |
|---|---|
| UIA_MenuClosedEventId | プラットフォームの実装では、アプリ バー コントロールが閉じられたときにこのイベントが発生する可能性があります。 |
| UIA_MenuOpenedEventId | プラットフォームの実装では、アプリ バー コントロールが開かれると、このイベントが発生する可能性があります。 |
| IUIAutomationPropertyChangedEventHandlerの | プロパティ変更イベント ハンドラー。 |
関連トピック