TreeView.ItemTemplate Propriété

Définition

Espace de noms:

Windows.UI.Xaml.Controls

Obtient ou définit le DataTemplate utilisé pour afficher chaque élément.

API WinUI 2 équivalente pour UWP : Microsoft.UI.Xaml.Controls.TreeView.ItemTemplate (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application 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"/>

Valeur de propriété

DataTemplate

Modèle qui spécifie la visualisation des objets de données. La valeur par défaut est null.

Configuration requise pour Windows

Famille d’appareils	Windows 10, version 1809 (introduit dans 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v7.0)

Exemples

Cet exemple montre comment appliquer un DataTemplate pour un objet défini Item localement. Pour obtenir le code qui définit Item et remplit le TreeView, consultez l’exemple « Tree View using data binding » dans l’article 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>

Remarques

Dans Windows 10, version 1803, il n’existe aucune propriété ItemTemplate. Au lieu de cela, vous devez re-modèler le contrôle TreeView et spécifier un ItemTemplate personnalisé si votre contenu n’est pas une chaîne. Cet exemple montre comment appliquer un DataTemplate à un élément d’arborescence dans Windows 10, version 1803. Pour obtenir le code qui définit Item et remplit le TreeView, consultez l’exemple « Tree View using data binding » dans l’article 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>