TreeView.ItemTemplate Propriedade

Definição

Namespace:

Windows.UI.Xaml.Controls

Obtém ou define o DataTemplate usado para exibir cada item.

API equivalente do WinUI 2 para UWP: Microsoft.UI.Xaml.Controls.TreeView.ItemTemplate (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo 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"/>

Valor da propriedade

DataTemplate

O modelo que especifica a visualização dos objetos de dados. O padrão é nulo.

Requisitos do Windows

Família de dispositivos	Windows 10, version 1809 (introduzida na 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v7.0)

Exemplos

Este exemplo mostra como aplicar um DataTemplate a um objeto definido Item localmente. Para o código que define Item e preenche o TreeView, consulte o exemplo "Exibição de árvore usando associação de dados" no artigo 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>

Comentários

No Windows 10, versão 1803, não há nenhuma propriedade ItemTemplate . Em vez disso, você precisa reexametar o controle TreeView e especificar um ItemTemplate personalizado se o conteúdo não for uma cadeia de caracteres. Este exemplo mostra como aplicar um DataTemplate a um item de exibição de árvore no Windows 10, versão 1803. Para o código que define Item e preenche o TreeView, consulte o exemplo "Exibição de árvore usando associação de dados" no artigo 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>