BreadcrumbBar 类

定义

命名空间:

Microsoft.UI.Xaml.Controls

控件 BreadcrumbBar 提供指向当前位置的页面或文件夹的直接路径。

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

/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class BreadcrumbBar : Control

[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class BreadcrumbBar : Control

Public Class BreadcrumbBar
Inherits Control

继承

Control

BreadcrumbBar

属性

Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

示例

提示

有关详细信息、设计指南和代码示例，请参阅 痕迹导航栏。

打开 WinUI 2 库应用，查看 BreadcrumbBar 的运行情况。

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

注解

提示

有关详细信息、设计指南和代码示例，请参阅 痕迹导航条概述。

提供 BreadcrumbBar 指向当前位置的页面或文件夹的直接路径。 该控件通常用于这样的情况：用户的导航轨迹（在文件系统或菜单系统中）需要持续可见，并且用户可能需要返回到前一位置。

如果调整应用大小后没有足够的空间可用于显示所有节点，则痕迹导航将会折叠并用省略号来代替最左侧的节点。 单击省略号会打开一个浮出窗口以显示折叠的节点。

控件样式和模板

可以修改默认 的 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 还包括可用于在不修改控件模板的情况下修改不同视觉状态下控件颜色的资源。 修改这些资源优先于设置 背景 和 前台等属性。 有关详细信息，请参阅 XAML 样式一文的轻量级样式部分。

构造函数

BreadcrumbBar()

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

属性

ItemsSource	获取或设置用于生成 的内容 BreadcrumbBar的对象源。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
ItemsSourceProperty	标识 ItemsSource 依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
ItemTemplate	获取或设置 BreadcrumbBarItem 的数据模板。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
ItemTemplateProperty	标识 ItemTemplate 依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。

事件

ItemClicked

在 BreadcrumbBar 中单击某个项时发生。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。

另请参阅

• 痕迹导航条概述