TreeView.ItemTemplate 屬性

定義

命名空間:

Windows.UI.Xaml.Controls

取得或設定用來顯示每個專案的 DataTemplate 。

適用于 UWP 的對等 WinUI 2 API：Microsoft.UI.Xaml.Controls.TreeView.ItemTemplate (在Windows 應用程式 SDK中，請參閱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。 For the code that defines Item and populates the TreeView, see the "Tree view using data binding" example in the TreeView article.

<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 版中的樹狀檢視專案。 For the code that defines Item and populates the TreeView, see the "Tree view using data binding" example in the TreeView article.

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