HierarchicalDataTemplate Kelas

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationFramework.dll

DataTemplate Mewakili yang mendukung HeaderedItemsControl, seperti TreeViewItem atau MenuItem.

public ref class HierarchicalDataTemplate : System::Windows::DataTemplate

public class HierarchicalDataTemplate : System.Windows.DataTemplate

type HierarchicalDataTemplate = class
    inherit DataTemplate

Public Class HierarchicalDataTemplate
Inherits DataTemplate

Warisan

Object

DispatcherObject

FrameworkTemplate

DataTemplate

HierarchicalDataTemplate

Contoh

Dalam contoh berikut, ListLeagueList adalah daftar objek League. Setiap objek League memiliki Name dan kumpulan objek Division. Setiap Division memiliki Name dan kumpulan objek Team, dan setiap objek Team memiliki Name.

<Window x:Class="SDKSample.Window1"
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  Title="HierarchicalDataTemplate Sample"
  xmlns:src="clr-namespace:SDKSample">
  <DockPanel>
    <DockPanel.Resources>
      <src:ListLeagueList x:Key="MyList"/>

      <HierarchicalDataTemplate DataType    = "{x:Type src:League}"
                                ItemsSource = "{Binding Path=Divisions}">
        <TextBlock Text="{Binding Path=Name}"/>
      </HierarchicalDataTemplate>

      <HierarchicalDataTemplate DataType    = "{x:Type src:Division}"
                                ItemsSource = "{Binding Path=Teams}">
        <TextBlock Text="{Binding Path=Name}"/>
      </HierarchicalDataTemplate>

      <DataTemplate DataType="{x:Type src:Team}">
        <TextBlock Text="{Binding Path=Name}"/>
      </DataTemplate>
    </DockPanel.Resources>

    <Menu Name="menu1" DockPanel.Dock="Top" Margin="10,10,10,10">
        <MenuItem Header="My Soccer Leagues"
                  ItemsSource="{Binding Source={StaticResource MyList}}" />
    </Menu>

    <TreeView>
      <TreeViewItem ItemsSource="{Binding Source={StaticResource MyList}}" Header="My Soccer Leagues" />
    </TreeView>

  </DockPanel>
</Window>

Contoh menunjukkan bahwa dengan penggunaan HierarchicalDataTemplate, Anda dapat dengan mudah menampilkan data daftar yang berisi daftar lain. Berikut ini adalah cuplikan layar contoh.

Konstruktor

Nama	Deskripsi
HierarchicalDataTemplate()	Menginisialisasi instans baru dari kelas HierarchicalDataTemplate.
HierarchicalDataTemplate(Object)	Menginisialisasi instans HierarchicalDataTemplate baru kelas dengan jenis yang ditentukan tempat templat dimaksudkan.

Properti

Nama	Deskripsi
AlternationCount	Mendapatkan atau mengatur jumlah kontainer item alternatif untuk item turunan.
DataTemplateKey	Mendapatkan kunci default dari DataTemplate. (Diperoleh dari DataTemplate)
DataType	Mendapatkan atau mengatur jenis yang DataTemplate dimaksudkan ini. (Diperoleh dari DataTemplate)
Dispatcher	Dispatcher Mendapatkan ini DispatcherObject dikaitkan dengan. (Diperoleh dari DispatcherObject)
HasContent	Mendapatkan nilai yang menunjukkan apakah templat ini memiliki konten yang dioptimalkan. (Diperoleh dari FrameworkTemplate)
IsSealed	Mendapatkan nilai yang menunjukkan apakah objek ini dalam status tidak dapat diubah sehingga tidak dapat diubah. (Diperoleh dari FrameworkTemplate)
ItemBindingGroup	Mendapatkan atau mengatur BindingGroup yang disalin ke setiap item anak.
ItemContainerStyle	Mendapatkan atau mengatur Style yang diterapkan ke kontainer item untuk setiap item anak.
ItemContainerStyleSelector	Mendapatkan atau mengatur logika pemilihan gaya kustom untuk gaya yang dapat diterapkan ke setiap kontainer item.
ItemsSource	Mendapatkan atau mengatur pengikatan untuk templat data ini, yang menunjukkan tempat menemukan koleksi yang mewakili tingkat berikutnya dalam hierarki data.
ItemStringFormat	Mendapatkan atau mengatur string komposit yang menentukan cara memformat item di tingkat berikutnya dalam hierarki data jika ditampilkan sebagai string.
ItemTemplate	Mendapatkan atau mengatur DataTemplate untuk diterapkan ke ItemTemplate properti pada yang dihasilkan HeaderedItemsControl (seperti MenuItem atau ), TreeViewItemuntuk menunjukkan cara menampilkan item dari tingkat berikutnya dalam hierarki data.
ItemTemplateSelector	Mendapatkan atau mengatur DataTemplateSelector untuk diterapkan ke ItemTemplateSelector properti pada yang dihasilkan HeaderedItemsControl (seperti MenuItem atau ), TreeViewItemuntuk menunjukkan cara memilih templat untuk menampilkan item dari tingkat berikutnya dalam hierarki data.
Resources	Mendapatkan atau mengatur kumpulan sumber daya yang dapat digunakan dalam cakupan templat ini. (Diperoleh dari FrameworkTemplate)
Template	Mendapatkan atau mengatur referensi ke objek yang merekam atau memutar simpul XAML untuk templat saat templat ditentukan atau diterapkan oleh penulis. (Diperoleh dari FrameworkTemplate)
Triggers	Mendapatkan kumpulan pemicu yang menerapkan nilai properti atau melakukan tindakan berdasarkan satu atau beberapa kondisi. (Diperoleh dari DataTemplate)
VisualTree	Mendapatkan atau mengatur simpul akar templat. (Diperoleh dari FrameworkTemplate)

Metode

Nama	Deskripsi
CheckAccess()	Menentukan apakah utas panggilan memiliki akses ke ini DispatcherObject. (Diperoleh dari DispatcherObject)
FindName(String, FrameworkElement)	Menemukan elemen yang terkait dengan nama yang ditentukan dalam templat ini. (Diperoleh dari FrameworkTemplate)
LoadContent()	Memuat konten templat sebagai instans objek dan mengembalikan elemen akar konten. (Diperoleh dari FrameworkTemplate)
RegisterName(String, Object)	Mendaftarkan pasangan nama/objek baru ke dalam cakupan nama saat ini. (Diperoleh dari FrameworkTemplate)
Seal()	Mengunci templat sehingga tidak dapat diubah. (Diperoleh dari FrameworkTemplate)
ShouldSerializeResources(XamlDesignerSerializationManager)	Mengembalikan nilai yang menunjukkan apakah proses serialisasi harus menserialisasikan nilai Resources properti pada instans kelas ini. (Diperoleh dari FrameworkTemplate)
ShouldSerializeVisualTree()	Mengembalikan nilai yang menunjukkan apakah proses serialisasi harus menserialisasikan nilai VisualTree properti pada instans kelas ini. (Diperoleh dari FrameworkTemplate)
UnregisterName(String)	Menghapus pemetaan nama/objek dari namescope XAML. (Diperoleh dari FrameworkTemplate)
ValidateTemplatedParent(FrameworkElement)	Memeriksa induk yang di-template terhadap sekumpulan aturan. (Diperoleh dari DataTemplate)
VerifyAccess()	Memberlakukan bahwa utas panggilan memiliki akses ke ini DispatcherObject. (Diperoleh dari DispatcherObject)

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
INameScope.FindName(String)	Mengembalikan objek yang memiliki nama pengidentifikasi yang disediakan. (Diperoleh dari FrameworkTemplate)
IQueryAmbient.IsAmbientPropertyAvailable(String)	Mengkueri apakah properti sekitar tertentu tersedia dalam cakupan saat ini. (Diperoleh dari FrameworkTemplate)