FrameworkElement.GetTemplateChild(String) Metoda

Definice

Vrátí pojmenovaný prvek ve vizuálním stromu instance 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

Parametry

childName
String

Jméno dítěte, které chcete najít.

Návraty

DependencyObject

Požadovaný prvek. Může to být null , pokud neexistuje žádný prvek požadovaného názvu.

Poznámky

Šablony ve WPF mají samostatný názvový rozsah. Je to proto, že se šablony znovu používají a jakýkoli název definovaný v šabloně nemůže zůstat jedinečný, pokud každý z instancí ovládacího prvku vytvoří instanci své šablony. GetTemplateChild Voláním metody vrátíte odkazy na objekty, které pocházejí ze šablony po vytvoření instance. Metodu FrameworkElement.FindName nelze použít k vyhledání položek ze šablon, protože FrameworkElement.FindName funguje v obecnějším oboru a neexistuje žádné propojení mezi ControlTemplate samotnou třídou a instancí šablony po použití.

FrameworkTemplate.FindName poskytuje stejnou funkci jako tato metoda. FrameworkTemplate.FindName je veřejná místo ochrany a používá správné aspekty oboru názvů, které umožňují přístup k šabloně v rámci elementu a vyhledání pojmenovaných položek v něm. Použijte FrameworkTemplate.FindName , když potřebujete získat prvek mimo nadřazený ovládací prvek.

Platí pro

Viz také