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 上取得原始程式碼

備註

您可以將其他控件包裝在 AppBarElementContainer中，以將其他控件新增至 CommandBarFlyout。 這包括 DropDownButton 或 SplitButton之類的控件，或 StackPanel 之類的容器，以取得更複雜的UI。

控件樣式和範本

您可以修改預設 的 Style 和 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 是否一律保持其 [展開] 狀態，並封鎖用戶進入 Collapsed 狀態。 預設為 False。
AreOpenCloseAnimationsEnabled	取得或設定值，這個值表示當飛出窗口開啟或關閉時，是否播放動畫。 (繼承來源 FlyoutBase)
Dispatcher	一律會在 Windows 應用程式 SDK 應用程式中傳null回。 請改用 DispatcherQueue 。 (繼承來源 DependencyObject)
DispatcherQueue	DispatcherQueue取得與這個 物件相關聯的 。 DispatcherQueue表示即使程式代碼是由非UI線程起始，也可以存取 DependencyObject UI線程上的設備。 (繼承來源 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)

另請參閱

• 命令列飛出視窗