TreeView 类

定义

命名空间:

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)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class TreeView : Control

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

Public Class TreeView
Inherits Control

继承

Control

TreeView

属性

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

示例

提示

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

打开 WinUI 2 库应用并查看 TreeView 的实际应用。

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

注解

控件样式和模板

可以修改默认 的 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 样式一文的轻量级样式部分。

构造函数

TreeView()

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

属性

CanDragItems	获取或设置一个值，该值指示视图中的项是否可以作为数据有效负载拖动。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
CanDragItemsProperty	标识 CanDragItems 依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
CanReorderItems	获取或设置一个值，该值指示视图中的项是否可以通过用户交互重新排序。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
CanReorderItemsProperty	标识 CanReorderItems 依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
ItemContainerStyle	获取或设置呈现项容器时使用的样式。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
ItemContainerStyleProperty	标识 ItemContainerStyle 依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
ItemContainerStyleSelector	获取或设置对自定义 StyleSelector 逻辑类的引用。 StyleSelector 根据所显示对象的特征返回用于项容器的不同 Style 值。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
ItemContainerStyleSelectorProperty	标识 ItemContainerStyleSelector 依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
ItemContainerTransitions	获取或设置应用于 TreeView 项容器的 Transition 样式元素的集合。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
ItemContainerTransitionsProperty	标识 ItemContainerTransitions 依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
ItemsSource	获取或设置用于生成 TreeView 内容的对象源。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
ItemsSourceProperty	标识 ItemsSource 依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
ItemTemplate	获取或设置用于显示每个项的 DataTemplate 。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
ItemTemplateProperty	标识 ItemTemplate 依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
ItemTemplateSelector	获取或设置对自定义 DataTemplateSelector 逻辑类的引用。 此属性引用的 DataTemplateSelector 返回要应用于项的模板。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
ItemTemplateSelectorProperty	标识 ItemTemplateSelector 依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
RootNodes	获取或设置树的根节点的集合。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
SelectedItem	获取或设置 TreeView 的 SelectedItem 属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
SelectedItemProperty	标识 SelectedItem 依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
SelectedItems	获取当前选定的项。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
SelectedNode	获取或设置在树中选择的节点。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
SelectedNodes	获取或设置树中选择的节点的集合。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
SelectionMode	获取或设置 TreeView 实例的选择行为。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
SelectionModeProperty	标识 SelectionMode 依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。

方法

Collapse(TreeViewNode)	折叠树中的指定节点。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
ContainerFromItem(Object)	返回与指定项对应的容器。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
ContainerFromNode(TreeViewNode)	返回与指定节点对应的容器。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
Expand(TreeViewNode)	展开树中的指定节点。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
ItemFromContainer(DependencyObject)	返回与指定的生成的容器对应的项。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
NodeFromContainer(DependencyObject)	返回与指定容器对应的 TreeViewNode。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
SelectAll()	选择树中的所有节点。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。

事件

Collapsed	当树中的节点折叠时发生。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
DragItemsCompleted	当涉及视图中某个项的拖动操作结束时发生。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
DragItemsStarting	在启动涉及视图中某个项的拖动操作时发生。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
Expanding	树中的节点开始展开时发生。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。
ItemInvoked	在调用树中的项时发生。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅Windows 应用 SDK命名空间) 。

另请参阅

• TreeViewCollapsedEventArgs
• TreeViewDragItemsCompletedEventArgs
• TreeViewDragItemsStartingEventArgs
• TreeViewExpandingEventArgs
• TreeViewItem
• TreeViewItemInvokedEventArgs
• TreeViewItemTemplateSettings
• TreeViewList
• TreeViewNode
• TreeViewSelectionMode
• TreeView 概述