FrameworkElement.GetTemplateChild(String) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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.