TreeView.ItemTemplate Eigenschaft

Definition

Namespace:

Windows.UI.Xaml.Controls

Ruft die DataTemplate ab, die zum Anzeigen der einzelnen Elemente verwendet wird, oder legt sie fest.

Entsprechende WinUI 2-API für UWP: Microsoft.UI.Xaml.Controls.TreeView.ItemTemplate (informationen zu WinUI in der Windows App SDK finden Sie in den Windows App SDK Namespaces).

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

Eigenschaftswert

DataTemplate

Die Vorlage, die die Visualisierung der Datenobjekte angibt. Der Standardwert ist NULL.

Windows-Anforderungen

Gerätefamilie	Windows 10, version 1809 (eingeführt in 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v7.0)

Beispiele

In diesem Beispiel wird gezeigt, wie Eine DataTemplate auf ein lokal definiertes Item Objekt angewendet wird. Den Code, der die TreeView definiert Item und auffüllt, finden Sie im Beispiel "Strukturansicht mit Datenbindung" im TreeView-Artikel.

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

Hinweise

In Windows 10 Version 1803 gibt es keine ItemTemplate-Eigenschaft. Stattdessen müssen Sie die Vorlage für das TreeView-Steuerelement neu erstellen und eine benutzerdefinierte ItemTemplate angeben, wenn ihr Inhalt keine Zeichenfolge ist. In diesem Beispiel wird gezeigt, wie Eine DataTemplate auf ein Strukturansichtselement in Windows 10, Version 1803, angewendet wird. Den Code, der die TreeView definiert Item und auffüllt, finden Sie im Beispiel "Strukturansicht mit Datenbindung" im TreeView-Artikel.

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