CommandBarFlyout クラス

定義

名前空間:

Microsoft.UI.Xaml.Controls

AppBarButton、AppBarToggleButton、および AppBarSeparator コントロールのレイアウトを提供する特殊なポップアップを表します。

/// [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")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class CommandBarFlyout : FlyoutBase

[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")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class CommandBarFlyout : FlyoutBase

Public Class CommandBarFlyout
Inherits FlyoutBase

<CommandBarFlyout .../>
-or-
<CommandBarFlyout>
  commandBarElements
</CommandBarFlyout>

継承

Object IInspectable DependencyObject FlyoutBase CommandBarFlyout

派生

Microsoft.UI.Xaml.Controls.TextCommandBarFlyout

属性

MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute ContractVersionAttribute

例

ヒント

詳細、設計ガイダンス、およびコード例については、「 コマンド バーのポップアップ」を参照してください。

WinUI 3 ギャラリー アプリを開き、CommandBarFlyout の動作を確認します。

WinUI 3 ギャラリー アプリには、ほとんどの WinUI 3 コントロールと機能の対話型の例が含まれています。 Microsoft Store からアプリを入手するか、GitHub でソース コードを取得します。

注釈

他のコントロールを CommandBarFlyout に追加するには、 AppBarElementContainer で折り返します。 これには、 DropDownButton や SplitButton などのコントロールや、より複雑な UI 用 の StackPanel などのコンテナーが含まれます。

コントロールのスタイルとテンプレート

既定の スタイル と ControlTemplate を変更して、コントロールに一意の外観を与えることができます。 コントロールのスタイルとテンプレートの変更については、「 XAML スタイル」を参照してください。 コントロールの外観を定義する既定のスタイル、テンプレート、およびリソースがファイルに generic.xaml 含まれます。 設計上の目的で、 generic.xaml は Windows アプリ SDK NuGet パッケージと共にインストールされます。 既定では、この場所は \Users\<username>\.nuget\packages\microsoft.windowsappsdk\<version>\lib\uap10.0\Microsoft.UI\Themes\generic.xaml です。 SDK の異なるバージョンのスタイルとリソースの値が異なる場合があります。

XAML には、コントロール テンプレートを変更せずに、さまざまなビジュアル状態のコントロールの色を変更するために使用できるリソースも含まれています。 これらのリソースを変更することは、 Background や Foreground などのプロパティを設定する場合に適 しています。 詳細については、XAML スタイルに関する記事の「軽量スタイル設定」セクションを参照してください。

コンストラクター

CommandBarFlyout()

CommandBarFlyout クラスの新しいインスタンスを初期化します。

プロパティ

AllowFocusOnInteraction	ユーザーが操作するときに要素が自動的にフォーカスを取得するかどうかを示す値を取得または設定します。 (継承元 FlyoutBase)
AllowFocusWhenDisabled	コントロールが無効になっているときにフォーカスを受け取ることができるかどうかを示す値を取得または設定します。 (継承元 FlyoutBase)
AlwaysExpanded	CommandBarFlyout を常に展開状態に保ち、ユーザーが折りたたまれた状態に入らないかどうかを示す値を取得または設定します。 既定値は false です。
AreOpenCloseAnimationsEnabled	ポップアップを開くか閉じたときにアニメーションを再生するかを示す値を取得または設定します。 (継承元 FlyoutBase)
Dispatcher	常に Windows アプリ SDK アプリで を返しますnull。 代わりに DispatcherQueue を使用してください。 (継承元 DependencyObject)
DispatcherQueue	このオブジェクトが DispatcherQueue 関連付けられている を取得します。 は DispatcherQueue 、コードが UI 以外のスレッドによって開始された場合でも、UI スレッド上の にアクセス DependencyObject できる機能を表します。 (継承元 DependencyObject)
ElementSoundMode	サウンドを再生するかどうかのコントロールの設定を指定する値を取得または設定します。 (継承元 FlyoutBase)
InputDevicePrefersPrimaryCommands	ポップアップを開くために使用される入力デバイスがセカンダリ コマンドを簡単に開かないかどうかを示す値を取得します。 (継承元 FlyoutBase)
IsConstrainedToRootBounds	XAML ルートの境界内にポップアップが表示されるかどうかを示す値を取得します。 このプロパティは、Windows アプリ SDK アプリでは常に true です。 (継承元 FlyoutBase)
IsOpen	ポップアップが開いているかどうかを示す値を取得します。 (継承元 FlyoutBase)
LightDismissOverlayMode	ライト無視 UI の外側の領域を暗くするかどうかを指定する値を取得または設定します。 (継承元 FlyoutBase)
OverlayInputPassThroughElement	ポップアップのオーバーレイの下にある場合でも、ポインター入力イベントを受け取る要素を取得または設定します。 (継承元 FlyoutBase)
Placement	ポップアップの配置ターゲットに対して使用される既定の配置を取得または設定します。 (継承元 FlyoutBase)
PrimaryCommands	CommandBarFlyout のプライマリ コマンド要素のコレクションを取得します。
SecondaryCommands	CommandBarFlyout のセカンダリ コマンド要素のコレクションを取得します。
ShouldConstrainToRootBounds	XAML ルートの境界内にポップアップを表示するかどうかを示す値を取得または設定します。 (継承元 FlyoutBase)
ShowMode	ポップアップが表示されたときの動作を示す値を取得または設定します。 (継承元 FlyoutBase)
SystemBackdrop	このポップアップに適用するシステムの背景を取得または設定します。 背景はポップアップ コンテンツの背後にレンダリングされます。 (継承元 FlyoutBase)
Target	ポップアップの配置ターゲットとして使用する要素を取得します。 (継承元 FlyoutBase)
XamlRoot	このポップアップを表示する XamlRoot を取得または設定します。 (継承元 FlyoutBase)

メソッド

ClearValue(DependencyProperty)	依存関係プロパティのローカル値をクリアします。 (継承元 DependencyObject)
CreatePresenter()	派生クラスでオーバーライドされた場合、派生コントロールに適したポップアップ コンテンツを表示するようにコントロールを初期化します。 注: このメソッドには基底クラスの実装がなく、派生クラスでオーバーライドする必要があります。 (継承元 FlyoutBase)
GetAnimationBaseValue(DependencyProperty)	依存関係プロパティに対して確立された基本値を返します。これは、アニメーションがアクティブでない場合に適用されます。 (継承元 DependencyObject)
GetValue(DependencyProperty)	DependencyObject から依存関係プロパティの現在の有効な値を返します。 (継承元 DependencyObject)
Hide()	ポップアップを閉じます。 (継承元 FlyoutBase)
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)	アプリでキーボード ショートカット (アクセラレータ) が処理される直前に呼び出されます。 アプリケーション コードまたは内部プロセスが ProcessKeyboardAccelerators を呼び出すたびに呼び出されます。 このメソッドをオーバーライドして、既定のアクセラレータ処理に影響を与える。 (継承元 FlyoutBase)
ReadLocalValue(DependencyProperty)	ローカル値が設定されている場合は、依存関係プロパティのローカル値を返します。 (継承元 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	この DependencyObject インスタンスの特定の DependencyProperty に対する変更をリッスンするための通知関数を登録します。 (継承元 DependencyObject)
SetValue(DependencyProperty, Object)	DependencyObject の依存関係プロパティのローカル値を設定します。 (継承元 DependencyObject)
ShowAt(DependencyObject, FlyoutShowOptions)	指定したオプションを使用して、指定した要素に対して配置されたポップアップを表示します。 (継承元 FlyoutBase)
ShowAt(FrameworkElement)	指定した要素に対して配置されたポップアップを表示します。 (継承元 FlyoutBase)
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)	キーボード ショートカット (アクセラレータ) を呼び出そうとします。 (継承元 FlyoutBase)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	RegisterPropertyChangedCallback を呼び出して以前に登録した変更通知を取り消します。 (継承元 DependencyObject)

イベント

Closed	ポップアップが非表示の場合に発生します。 (継承元 FlyoutBase)
Closing	ポップアップが非表示になり始めると発生します。 (継承元 FlyoutBase)
Opened	ポップアップが表示されるときに発生します。 (継承元 FlyoutBase)
Opening	ポップアップが表示される前に発生します。 (継承元 FlyoutBase)

こちらもご覧ください

• コマンド バーのポップアップ