TreeView.ItemTemplate Eigenschaft

Referenz

Definition

Namespace:: Windows.UI.Xaml.Controls

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

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>

Gilt für:

Freigeben über