Flyout 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示显示信息或需要用户交互的轻型 UI 的控件。 与对话框不同，浮出控件可以通过单击或点击其外部、按设备的后退按钮或按“Esc”键来轻松消除浮出控件。
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Content")]
class Flyout : FlyoutBase[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Content")]
public class Flyout : FlyoutBasePublic Class Flyout
Inherits FlyoutBase<Flyout>
singleUIElement
</Flyout>
- 继承
- 属性
Windows 要求
| 设备系列 |
Windows 10 (在 10.0.10240.0 中引入)
|
| API contract |
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)
|
示例
提示
有关详细信息、设计指南和代码示例，请参阅 浮出控件。
WinUI 2 库应用包括大多数 WinUI 2 控件、特性和功能的交互式示例。 通过 Microsoft Store 获取应用，或在 GitHub 上获取源代码。
注解
浮出控件显示需要用户交互的消息。
使用浮出控件收集信息、显示详细信息或警告和确认。 与对话不同，浮出控件不会创建单独的窗口，也不会阻止其他用户交互。 若要显示项菜单，请改用 MenuFlyout 。 有关详细信息（包括 XAML 和代码示例），请参阅 快速入门：添加浮出控件。
浮出控件 (或 MenuFlyout) 用作 Button.Flyout 属性的值。 这通常在 XAML 中设置为页面 UI 定义的一部分。 Button 是唯一具有专用 浮出控件 属性的控件。 若要将浮出控件与其他控件相关联，请使用 FlyoutBase.AttachedFlyout 附加属性。 设置为 Button.Flyout 时，当点击或以其他方式调用按钮时，浮出控件会显示。 使用 FlyoutBase.AttachedFlyout 将浮出控件分配给其他 UI 元素时，必须调用 ShowAt 方法或静态 ShowAttachedFlyout 方法来显示浮出控件。
除了此参考主题中列出的成员外，基类 FlyoutBase 的其他成员通常用于典型的浮出控件方案：
- FlyoutBase.AttachedFlyout：一个附加属性，它将 Flyout 与特定 UI 元素相关联， (它可以是任何 FrameworkElement 派生类) 。
- ShowAttachedFlyout：一种静态方法，可以确定浮出控件是否已通过 FlyoutBase.AttachedFlyout 分配与 UI 元素相关联。 如果是这样，该方法使用指定的 FrameworkElement 在内部调用 ShowAt。
可访问性
如果使用无可聚焦内容的浮出控件（例如，仅包含文本），则应采取一些附加步骤来确保内容可访问。 具体而言，你需要确保 Windows 讲述人或其他屏幕阅读器可以读取浮出控件的内容。
默认情况下， FlyoutPresenter 上设置了阻止其接收焦点的属性。 这是当浮出控件内的内容可以接收焦点时所需的行为。 但是，如果浮出控件内的内容无法接收焦点，则应更新到 FlyoutPresenterStyle ，让 FlyoutPresenter 改为接收焦点。 为此，请在浮出控件演示器样式上将 IsTabStop 设置为 true ，将 TabNavigation 设置为 Cycle 。
此示例演示如何让 FlyoutPresenter 接收焦点，以便访问内容。
<Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
<Button VerticalAlignment="Center" HorizontalAlignment="Center"
Content="Open flyout">
<Button.Flyout>
<Flyout>
<Flyout.FlyoutPresenterStyle>
<Style TargetType="FlyoutPresenter">
<Setter Property="ScrollViewer.HorizontalScrollMode" Value="Disabled"/>
<Setter Property="ScrollViewer.HorizontalScrollBarVisibility" Value="Disabled"/>
<Setter Property="IsTabStop" Value="True"/>
<Setter Property="TabNavigation" Value="Cycle"/>
</Style>
</Flyout.FlyoutPresenterStyle>
<TextBlock TextWrapping="Wrap" Text="This is some text in a flyout."/>
</Flyout>
</Button.Flyout>
</Button>
</Grid>
构造函数
| Flyout() |
初始化 Flyout 类的新实例。 |
属性
| AllowFocusOnInteraction |
获取或设置一个值，该值指示当用户与元素交互时是否自动获取焦点。 (继承自 FlyoutBase) |
| AllowFocusWhenDisabled |
获取或设置一个值，该值指定控件在禁用时是否可以接收焦点。 (继承自 FlyoutBase) |
| AreOpenCloseAnimationsEnabled |
获取或设置一个值，该值指示在打开还是关闭浮出控件时播放动画。 (继承自 FlyoutBase) |
| Content |
获取或设置 浮出控件的内容。 |
| ContentProperty |
获取 Content 依赖属性的标识符。 |
| Dispatcher |
获取与此对象关联的 CoreDispatcher 。 CoreDispatcher 表示可以访问 UI 线程上的 DependencyObject 的工具，即使代码是由非 UI 线程启动的。 (继承自 DependencyObject) |
| ElementSoundMode |
获取或设置一个值，该值指定控件是否播放声音的首选项。 (继承自 FlyoutBase) |
| FlyoutPresenterStyle | |
| FlyoutPresenterStyleProperty |
获取 FlyoutPresenterStyle 依赖属性的标识符。 |
| InputDevicePrefersPrimaryCommands |
获取一个值，该值指示用于打开浮出控件的输入设备是否不容易打开辅助命令。 (继承自 FlyoutBase) |
| IsConstrainedToRootBounds |
获取一个值，该值指示浮出控件是否显示在 XAML 根的边界内。 (继承自 FlyoutBase) |
| IsOpen |
获取一个值，该值指示浮出控件是否处于打开状态。 (继承自 FlyoutBase) |
| LightDismissOverlayMode |
获取或设置一个值，该值指定是否将 浅色消除 UI 外部的区域变暗。 (继承自 FlyoutBase) |
| OverlayInputPassThroughElement |
获取或设置一个元素，该元素应接收指针输入事件，即使在浮出控件的覆盖层下也是如此。 (继承自 FlyoutBase) |
| Placement |
获取或设置浮出控件相对于其放置目标的默认放置。 (继承自 FlyoutBase) |
| ShouldConstrainToRootBounds |
获取或设置一个值，该值指示是否应在 XAML 根的边界内显示浮出控件。 (继承自 FlyoutBase) |
| ShowMode |
获取或设置一个值，该值指示浮出控件在显示时的行为方式。 (继承自 FlyoutBase) |
| Target |
获取要用作浮出控件放置目标的元素。 (继承自 FlyoutBase) |
| XamlRoot |
获取或设置在其中查看此浮出控件的 XamlRoot。 (继承自 FlyoutBase) |
方法
事件
| Closed |
浮出控件隐藏时发生。 (继承自 FlyoutBase) |
| Closing |
浮出控件开始隐藏时发生。 (继承自 FlyoutBase) |
| Opened |
在显示浮出控件时发生。 (继承自 FlyoutBase) |
| Opening |
在显示浮出控件之前发生。 (继承自 FlyoutBase) |
适用于
另请参阅
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈