共用方式為


CommandBarFlyout 類別

定義

表示提供 AppBarButton 和相關命令元素配置的特殊飛出視窗。

適用于 UWP 的對等 WinUI 2 APIMicrosoft.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 : FlyoutBase
Public Class CommandBarFlyout
Inherits FlyoutBase
<CommandBarFlyout .../>
-or-
<CommandBarFlyout>
  commandBarElements
</CommandBarFlyout>
繼承
Object IInspectable DependencyObject FlyoutBase CommandBarFlyout
衍生
屬性

Windows 需求

裝置系列
Windows 10, version 1809 (已於 10.0.17763.0 引進)
API contract
Windows.Foundation.UniversalApiContract (已於 v7.0 引進)

範例

提示

如需詳細資訊、設計指引和程式碼範例,請參閱 命令列飛出視窗

如果您已安裝 WinUI 2 資源庫 應用程式,請按一下這裡 開啟應用程式並查看 CommandBarFlyout 運作情形

備註

控制項樣式和範本

您可以修改預設 的 StyleControlTemplate ,讓控制項具有唯一的外觀。 如需修改控制項樣式和範本的相關資訊,請參閱 設定控制項的樣式。 定義控制面板的預設樣式、範本和資源會包含在 檔案中 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 也包含資源,可讓您用來修改不同視覺狀態中控制項的色彩,而不需修改控制項範本。 修改這些資源是慣用的設定屬性,例如 BackgroundForeground。 如需詳細資訊,請參閱XAML 樣式文章的輕量型樣式一節。 從 Windows 10 版本 1607 (SDK 14393) 開始,即可使用輕量型樣式資源。

建構函式

CommandBarFlyout()

初始化 CommandBarFlyout 類別的新實例。

適用于 UWP 的對等 WinUI 2 APIMicrosoft.UI.Xaml.Controls.CommandBarFlyout.-ctor (for WinUI Windows 應用程式 SDK,請參閱Windows 應用程式 SDK命名空間) 。

屬性

AllowFocusOnInteraction

取得或設定值,這個值表示當使用者與其互動時,專案是否會自動取得焦點。

(繼承來源 FlyoutBase)
AllowFocusWhenDisabled

取得或設定值,指定控制項在停用時是否可以接收焦點。

(繼承來源 FlyoutBase)
AreOpenCloseAnimationsEnabled

取得或設定值,這個值表示當飛出視窗開啟或關閉時,是否播放動畫。

(繼承來源 FlyoutBase)
Dispatcher

取得這個 物件相關聯的 CoreDispatcherCoreDispatcher代表可在 UI 執行緒上存取DependencyObject的功能,即使程式碼是由非 UI 執行緒起始也一樣。

(繼承來源 DependencyObject)
ElementSoundMode

取得或設定值,指定控制項是否播放音效的喜好設定。

(繼承來源 FlyoutBase)
InputDevicePrefersPrimaryCommands

取得值,指出用來開啟飛出視窗的輸入裝置是否不容易開啟次要命令。

(繼承來源 FlyoutBase)
IsConstrainedToRootBounds

取得值,這個值表示飛出視窗是否顯示在 XAML 根目錄的界限內。

(繼承來源 FlyoutBase)
IsOpen

取得值,這個值表示飛出視窗是否開啟。

(繼承來源 FlyoutBase)
LightDismissOverlayMode

取得或設定值,這個值會指定 淺色關閉 UI 外部的區域是否變深。

(繼承來源 FlyoutBase)
OverlayInputPassThroughElement

取得或設定即使飛出視窗重迭下方的指標輸入事件,也應該接收指標輸入事件的專案。

(繼承來源 FlyoutBase)
Placement

取得或設定要用於飛出視窗的預設放置位置,相對於其放置目標。

(繼承來源 FlyoutBase)
PrimaryCommands

取得 CommandBarFlyout的主要命令元素集合。

適用于 UWP 的對等 WinUI 2 APIMicrosoft.UI.Xaml.Controls.CommandBarFlyout.PrimaryCommands (for WinUI 在Windows 應用程式 SDK中,請參閱Windows 應用程式 SDK命名空間) 。

SecondaryCommands

取得 CommandBarFlyout的次要命令元素集合。

適用于 UWP 的對等 WinUI 2 APIMicrosoft.UI.Xaml.Controls.CommandBarFlyout.SecondaryCommands (Windows 應用程式 SDK中的 WinUI,請參閱Windows 應用程式 SDK命名空間) 。

ShouldConstrainToRootBounds

取得或設定值,這個值表示是否應該在 XAML 根目錄的界限內顯示飛出視窗。

(繼承來源 FlyoutBase)
ShowMode

取得或設定值,這個值表示顯示飛出視窗的行為。

(繼承來源 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)

適用於