TreeView.ItemTemplate 属性

定义

命名空间:

Windows.UI.Xaml.Controls

获取或设置用于显示每个项的 DataTemplate 。

适用于 UWP 的等效 WinUI 2 API：Windows 应用 SDK中适用于 WinUI 的 Microsoft.UI.Xaml.Controls.TreeView.ItemTemplate (，请参阅 ) Windows 应用 SDK命名空间。

DataTemplate ItemTemplate();

void ItemTemplate(DataTemplate value);

public DataTemplate ItemTemplate { get; set; }

var dataTemplate = treeView.itemTemplate;
treeView.itemTemplate = dataTemplate;

Public Property ItemTemplate As DataTemplate

<TreeView>
  <TreeView.ItemTemplate>
    singleDataTemplate
  </TreeView.ItemTemplate>
</TreeView>
- or -
<TreeView ItemTemplate="resourceReferenceToDataTemplate"/>

属性值

DataTemplate

指定数据对象的可视化效果的模板。 默认值为 null。

Windows 要求

设备系列	Windows 10, version 1809 (在 10.0.17763.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v7.0 中引入)

示例

此示例演示如何为本地定义的Item对象应用 DataTemplate。 有关定义 Item 和填充 TreeView 的代码，请参阅 TreeView 一文中的“使用数据绑定的 树视图 ”示例。

<TreeView Name="DessertTree"
          SelectionMode="Multiple"
          ItemsSource="{x:Bind DataSource}">
    <TreeView.ItemTemplate>
        <DataTemplate x:DataType="local:Item">
            <TreeViewItem ItemsSource="{x:Bind Children}"
                          Content="{x:Bind Name}"/>
        </DataTemplate>
    </TreeView.ItemTemplate>
</TreeView>

注解

在 Windows 10 版本 1803 中，没有 ItemTemplate 属性。 相反，如果内容不是字符串，则必须重新创建 TreeView 控件模板并指定自定义 ItemTemplate 。 此示例演示如何将 DataTemplate 应用于 Windows 10 版本 1803 中的树视图项。 有关定义 Item 和填充 TreeView 的代码，请参阅 TreeView 一文中的“使用数据绑定的 树视图 ”示例。

<Page.Resources>
    <DataTemplate x:Key="TreeViewItemDataTemplate" x:DataType="local:Item">
        <TreeViewItem ItemsSource="{x:Bind Children}"
                      Content="{x:Bind Name}"/>
    </DataTemplate>

    <Style TargetType="TreeView">
        <Setter Property="IsTabStop" Value="False" />
        <Setter Property="Template">
            <Setter.Value>
                <ControlTemplate TargetType="TreeView">
                    <TreeViewList x:Name="ListControl"
                                  ItemTemplate="{StaticResource TreeViewItemDataTemplate}"
                                  ItemContainerStyle="{StaticResource TreeViewItemStyle}"
                                  CanDragItems="True"
                                  AllowDrop="True"
                                  CanReorderItems="True">
                        <TreeViewList.ItemContainerTransitions>
                            <TransitionCollection>
                                <ContentThemeTransition />
                                <ReorderThemeTransition />
                                <EntranceThemeTransition IsStaggeringEnabled="False" />
                            </TransitionCollection>
                        </TreeViewList.ItemContainerTransitions>
                    </TreeViewList>
                </ControlTemplate>
            </Setter.Value>
        </Setter>
    </Style>
</Page.Resources>
<Grid>
    <TreeView Name="DessertTree"
              ItemsSource="{x:Bind DataSource}"/>
</Grid>