CommandBarFlyout 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示为 AppBarButton 和相关命令元素提供布局的专用浮出控件。
适用于 UWP 的等效 WinUI 2 API：Microsoft.UI.Xaml.Controls.CommandBar 在 Windows 应用 SDK中适用于 WinUI 的 Microsoft.UI.Xaml.Controls.CommandBarFlyout (，请参阅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：Windows 应用 SDK中适用于 WinUI 的 Microsoft.UI.Xaml.Controls.CommandBarFlyout.-ctor (，请参阅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：Windows 应用 SDK中适用于 WinUI 的 Microsoft.UI.Xaml.Controls.CommandBarFlyout.PrimaryCommands (，请参阅Windows 应用 SDK命名空间) 。 |
| SecondaryCommands |
获取 CommandBarFlyout 的辅助命令元素的集合。 适用于 UWP 的等效 WinUI 2 API：Windows 应用 SDK中适用于 WinUI 的 Microsoft.UI.Xaml.Controls.CommandBarFlyout.SecondaryCommands (，请参阅) 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。
提交和查看相关反馈