CommandBarFlyout クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
AppBarButton と関連するコマンド要素のレイアウトを提供する特殊なポップアップを表します。
UWP 用の同等の WinUI 2 API: Microsoft.UI.Xaml.Controls.CommandBarFlyout (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 458752)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="PrimaryCommands")]
class CommandBarFlyout : FlyoutBase[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 458752)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="PrimaryCommands")]
public class CommandBarFlyout : FlyoutBasePublic Class CommandBarFlyout
Inherits FlyoutBase<CommandBarFlyout .../>
-or-
<CommandBarFlyout>
commandBarElements
</CommandBarFlyout>
- 継承
- 派生
- 属性
Windows の要件
| デバイス ファミリ |
Windows 10, version 1809 (10.0.17763.0 で導入)
|
| API contract |
Windows.Foundation.UniversalApiContract (v7.0 で導入)
|
例
ヒント
詳細、設計ガイダンス、およびコード例については、「 コマンド バーのポップアップ」を参照してください。
WinUI 2 ギャラリー アプリがインストールされている場合は、ここをクリックしてアプリを開き、CommandBarFlyout の動作を確認します。
注釈
コントロール のスタイルとテンプレート
既定の Style と ControlTemplate を変更して、コントロールに一意の外観を与えることができます。 コントロールのスタイルとテンプレートの変更の詳細については、「コントロールの スタイル設定」を参照してください。 コントロールの外観を定義する既定のスタイル、テンプレート、およびリソースがファイルに generic.xaml 含まれます。 設計上の目的で、 generic.xaml は SDK または NuGet パッケージのインストールでローカルで使用できます。
- * WinUI スタイル (推奨):Microsoft.UI.Xaml.Controls.CommandBarFlyout を使用します。
-
WinUI 以外のスタイル: 組み込みのスタイルについては、「」を参照してください
%ProgramFiles(x86)%\Windows Kits\10\DesignTime\CommonConfiguration\Neutral\UAP\<SDK version>\Generic\generic.xaml。
インストールをカスタマイズした場合、場所が異なる場合があります。 SDK の異なるバージョンのスタイルとリソースの値が異なる場合があります。
XAML には、コントロール テンプレートを変更せずに、さまざまなビジュアル状態でコントロールの色を変更するために使用できるリソースも含まれています。 これらのリソースの変更は、 Background や Foreground などのプロパティを設定する場合に推奨 されます。 詳細については、XAML スタイルに関する記事の「軽量のスタイル設定」セクションを参照してください。 軽量のスタイル設定リソースは、Windows 10 バージョン 1607 (SDK 14393) 以降で使用できます。
コンストラクター
| CommandBarFlyout() |
CommandBarFlyout クラスの新しいインスタンスを初期化します。 UWP 用の同等の WinUI 2 API: Microsoft.UI.Xaml.Controls.CommandBarFlyout.-ctor (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。 |
プロパティ
| AllowFocusOnInteraction |
ユーザーが操作するときに要素が自動的にフォーカスを取得するかどうかを示す値を取得または設定します。 (継承元 FlyoutBase) |
| AllowFocusWhenDisabled |
コントロールが無効になっているときにフォーカスを受け取ることができるかどうかを示す値を取得または設定します。 (継承元 FlyoutBase) |
| AreOpenCloseAnimationsEnabled |
ポップアップを開くか閉じたときにアニメーションを再生するかを示す値を取得または設定します。 (継承元 FlyoutBase) |
| Dispatcher |
このオブジェクトが関連付けられている CoreDispatcher を取得します。 CoreDispatcher は、コードが UI 以外のスレッドによって開始された場合でも、UI スレッド上の DependencyObject にアクセスできる機能を表します。 (継承元 DependencyObject) |
| ElementSoundMode |
サウンドを再生するかどうかのコントロールの設定を指定する値を取得または設定します。 (継承元 FlyoutBase) |
| InputDevicePrefersPrimaryCommands |
ポップアップを開くために使用される入力デバイスがセカンダリ コマンドを簡単に開かないかどうかを示す値を取得します。 (継承元 FlyoutBase) |
| IsConstrainedToRootBounds |
ポップアップが XAML ルートの境界内に表示されるかどうかを示す値を取得します。 (継承元 FlyoutBase) |
| IsOpen |
ポップアップが開いているかどうかを示す値を取得します。 (継承元 FlyoutBase) |
| LightDismissOverlayMode |
ライトを閉じる UI の外側の領域を暗くするかどうかを指定する値を取得または設定します。 (継承元 FlyoutBase) |
| OverlayInputPassThroughElement |
ポップアップのオーバーレイの下にある場合でも、ポインター入力イベントを受け取る要素を取得または設定します。 (継承元 FlyoutBase) |
| Placement |
ポップアップの配置ターゲットに対して使用される既定の配置を取得または設定します。 (継承元 FlyoutBase) |
| PrimaryCommands |
CommandBarFlyout のプライマリ コマンド要素のコレクションを取得します。 UWP 用の同等の WinUI 2 API: Microsoft.UI.Xaml.Controls.CommandBarFlyout.PrimaryCommands (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。 |
| SecondaryCommands |
CommandBarFlyout のセカンダリ コマンド要素のコレクションを取得します。 UWP 用の同等の WinUI 2 API: Microsoft.UI.Xaml.Controls.CommandBarFlyout.SecondaryCommands (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。 |
| ShouldConstrainToRootBounds |
ポップアップを XAML ルートの境界内に表示するかどうかを示す値を取得または設定します。 (継承元 FlyoutBase) |
| ShowMode |
表示時のポップアップの動作を示す値を取得または設定します。 (継承元 FlyoutBase) |
| Target |
ポップアップの配置ターゲットとして使用する要素を取得します。 (継承元 FlyoutBase) |
| XamlRoot |
このポップアップを表示する XamlRoot を取得または設定します。 (継承元 FlyoutBase) |
メソッド
イベント
| Closed |
ポップアップが非表示のときに発生します。 (継承元 FlyoutBase) |
| Closing |
ポップアップが非表示になり始めると発生します。 (継承元 FlyoutBase) |
| Opened |
ポップアップが表示されるときに発生します。 (継承元 FlyoutBase) |
| Opening |
ポップアップが表示される前に発生します。 (継承元 FlyoutBase) |