Expander 类

定义

命名空间:

Microsoft.UI.Xaml.Controls

表示显示标头并具有显示内容的可折叠正文的控件。

本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class Expander : ContentControl

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class Expander : ContentControl

Public Class Expander
Inherits ContentControl

继承

ContentControl

Expander

属性

MarshalingBehaviorAttribute ThreadingAttribute ContractVersionAttribute

示例

提示

有关详细信息、设计指南和代码示例，请参阅 Expander。

打开 WinUI 2 库应用，查看扩展器在操作。

WinUI 2 库应用包括大多数 WinUI 2 控件、特性和功能的交互式示例。 通过 Microsoft Store 获取应用，或在 GitHub 上获取源代码。

注解

提示

有关详细信息、设计指南和代码示例，请参阅 扩展器概述。

当显示空间有限时， Expander 使用 专注于最重要的内容。 控件 Expander 允许显示或隐藏与始终可见的一部分主要内容相关的不太重要的内容。 标头中包含的项始终可见。 用户可以通过与 标头交互来展开和折叠显示辅助内容的内容区域。 内容区域展开后，会使其他 UI 元素跳出；它不会覆盖其他 UI。 Expander 可以向上或向下展开。

Header 和 Content 区域均可包含从简单文本到复杂 UI 布局的任何内容。

控件样式和模板

可以修改默认 的 Style 和 ControlTemplate ，使控件具有唯一的外观。 有关修改控件的样式和模板的信息，请参阅 XAML 样式。 文件中包括 generic.xaml 定义控件外观的默认样式、模板和资源。 出于设计目的， generic.xaml 随 WinUI (Microsoft.UI.Xaml) NuGet 包一起安装。 默认情况下，此位置是 \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml。 来自不同版本的 WinUI 的样式和资源可能具有不同的值。

XAML 还包括可用于在不修改控件模板的情况下修改不同视觉状态中的控件颜色的资源。 修改这些资源是首选设置属性，如 Background 和 Foreground。 有关详细信息，请参阅 XAML 样式一文的轻量级样式部分。

构造函数

Expander()

初始化 Expander 类的新实例。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。

属性

ExpandDirection	获取或设置一个值，该值指示内容区域的扩展方向。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
ExpandDirectionProperty	标识 ExpandDirection 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
Header	获取或设置 扩展器标头中显示的 XAML 内容。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
HeaderProperty	标识 Header 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
HeaderTemplate	获取或设置 Expander.Header 的数据模板。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
HeaderTemplateProperty	标识 HeaderTemplate 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
HeaderTemplateSelector	获取或设置对自定义 DataTemplateSelector 逻辑类的引用，该类返回要应用于 Header 的模板。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
HeaderTemplateSelectorProperty	标识 HeaderTemplateSelector 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
IsExpanded	获取或设置一个值，该值指示是否显示 扩展器 的内容区域。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
IsExpandedProperty	标识 IsExpanded 依赖属性。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
TemplateSettings	获取一个 对象，该对象提供可在定义扩展器模板时作为 TemplatedParent 源引用的计算值。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。

事件

Collapsed	隐藏 扩展器 的内容区域时发生。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。
Expanding	当 扩展器 的内容区域开始显示时发生。 本文档适用于Windows 应用 SDK中适用于 UWP 的 WinUI 2 (，请参阅Windows 应用 SDK命名空间) 。

另请参阅

• 扩展器概述