TreeView.ItemTemplate Properti

Definisi

Ruang nama:

Windows.UI.Xaml.Controls

Mendapatkan atau mengatur DataTemplate yang digunakan untuk menampilkan setiap item.

API WinUI 2 yang setara untuk UWP: Microsoft.UI.Xaml.Controls.TreeView.ItemTemplate (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).

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"/>

Nilai Properti

DataTemplate

Templat yang menentukan visualisasi objek data. Defaultnya adalah null.

Persyaratan Windows

Rangkaian perangkat	Windows 10, version 1809 (diperkenalkan dalam 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v7.0)

Contoh

Contoh ini memperlihatkan cara menerapkan DataTemplate untuk objek yang ditentukan Item secara lokal. Untuk kode yang menentukan Item dan mengisi TreeView, lihat contoh "Tampilan pohon menggunakan pengikatan data" di artikel 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>

Keterangan

Dalam Windows 10, versi 1803, tidak ada properti ItemTemplate. Sebagai gantinya, Anda harus membuat templat ulang kontrol TreeView dan menentukan Item KustomTemplate jika konten Anda bukan string. Contoh ini memperlihatkan cara menerapkan DataTemplate ke item tampilan pohon di Windows 10 versi 1803. Untuk kode yang menentukan Item dan mengisi TreeView, lihat contoh "Tampilan pohon menggunakan pengikatan data" di artikel 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>