TreeView.ItemTemplate Proprietà

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Controls

Ottiene o imposta l'oggetto DataTemplate usato per visualizzare ogni elemento.

API WinUI 2 equivalente per UWP: Microsoft.UI.Xaml.Controls.TreeView.ItemTemplate (per WinUI nell'SDK per app di Windows, vedere gli spazi dei nomi SDK per app di 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"/>

Valore della proprietà

DataTemplate

Modello che specifica la visualizzazione degli oggetti dati. Il valore predefinito è Null.

Requisiti Windows

Famiglia di dispositivi	Windows 10, version 1809 (è stato introdotto in 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v7.0)

Esempio

In questo esempio viene illustrato come applicare un oggetto DataTemplate per un oggetto definito Item in locale. Per il codice che definisce Item e popola treeView, vedere l'esempio "Visualizzazione albero usando data binding" nell'articolo 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>

Commenti

In Windows 10 versione 1803 non esiste alcuna proprietà ItemTemplate. È invece necessario riconfigurare il controllo TreeView e specificare un elemento ItemTemplate personalizzato se il contenuto non è una stringa. In questo esempio viene illustrato come applicare un oggetto DataTemplate a un elemento della visualizzazione albero in Windows 10 versione 1803. Per il codice che definisce Item e popola treeView, vedere l'esempio "Visualizzazione albero usando data binding" nell'articolo 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>