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 引進)
|
範例
備註
控制項樣式和範本
您可以修改預設 的 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 (for WinUI Windows 應用程式 SDK，請參閱Windows 應用程式 SDK命名空間) 。 |
屬性
| AllowFocusOnInteraction |
取得或設定值，這個值表示當使用者與其互動時，專案是否會自動取得焦點。 (繼承來源 FlyoutBase) |
| AllowFocusWhenDisabled |
取得或設定值，指定控制項在停用時是否可以接收焦點。 (繼承來源 FlyoutBase) |
| AreOpenCloseAnimationsEnabled |
取得或設定值，這個值表示當飛出視窗開啟或關閉時，是否播放動畫。 (繼承來源 FlyoutBase) |
| Dispatcher |
取得這個 物件相關聯的 CoreDispatcher 。 CoreDispatcher代表可在 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 API：Microsoft.UI.Xaml.Controls.CommandBarFlyout.PrimaryCommands (for WinUI 在Windows 應用程式 SDK中，請參閱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) |
適用於
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應