FrameworkElement.GetTemplateChild(String) Metode

Definisi

Mengembalikan elemen bernama di pohon visual dari instans ControlTemplate.

protected public:
 System::Windows::DependencyObject ^ GetTemplateChild(System::String ^ childName);
protected internal System.Windows.DependencyObject GetTemplateChild(string childName);
member this.GetTemplateChild : string -> System.Windows.DependencyObject
Protected Friend Function GetTemplateChild (childName As String) As DependencyObject

Parameter

childName
String

Nama anak yang akan ditemukan.

Mengembalikan

Elemen yang diminta. Mungkin null jika tidak ada elemen nama yang diminta.

Keterangan

Templat di WPF memiliki namescope mandiri. Ini karena templat digunakan kembali, dan nama apa pun yang ditentukan dalam templat tidak dapat tetap unik ketika beberapa instans kontrol setiap membuat instans templatnya. GetTemplateChild Panggil metode untuk mengembalikan referensi ke objek yang berasal dari templat setelah dibuat. Anda tidak dapat menggunakan FrameworkElement.FindName metode untuk menemukan item dari templat karena FrameworkElement.FindName bertindak dalam cakupan yang lebih umum, dan tidak ada koneksi antara kelas itu ControlTemplate sendiri dan templat yang dibuat setelah diterapkan.

FrameworkTemplate.FindName memasok fungsi yang sama dengan metode ini. FrameworkTemplate.FindName bersifat publik alih-alih dilindungi, dan menggunakan pertimbangan pencakupan nama yang benar yang memungkinkannya mengakses templat dalam elemen dan menemukan item bernama di dalamnya. Gunakan FrameworkTemplate.FindName saat Anda perlu mendapatkan elemen di luar kontrol induknya.

Berlaku untuk

Lihat juga