TreeView.ItemTemplate Свойство

Определение

Пространство имен:

Windows.UI.Xaml.Controls

Возвращает или задает объект DataTemplate, используемый для отображения каждого элемента.

Эквивалентный API WinUI 2 для UWP: Microsoft.UI.Xaml.Controls.TreeView.ItemTemplate (для WinUI в Windows App SDK см. Windows App 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)

Примеры

В этом примере показано, как применить DataTemplate к локально определенному Item объекту. Код, который определяет и заполняет ItemTreeView, см. в примере "Представление дерева с использованием привязки данных" статьи 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. Код, который определяет и заполняет ItemTreeView, см. в примере "Представление дерева с использованием привязки данных" статьи 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>