Control.GetTemplateChild(String) Method

Definition

Retrieves the named element in the instantiated ControlTemplate visual tree.

protected:
 virtual DependencyObject ^ GetTemplateChild(Platform::String ^ childName) = GetTemplateChild;
DependencyObject GetTemplateChild(winrt::hstring const& childName);
protected DependencyObject GetTemplateChild(string childName);
function getTemplateChild(childName)
Protected Function GetTemplateChild (childName As String) As DependencyObject

Parameters

childName
String

Platform::String

winrt::hstring

The name of the element to find.

Returns

The named element from the template, if the element is found. Can return null if no element with name childName was found in the template.

Remarks

You call GetTemplateChild to get references to objects in a controls Template after it's instantiated. The ControlTemplate is instantiated in the OnApplyTemplate method. You can use the GetTemplateChild method inside your OnApplyTemplate override and keep a reference to the objects you need.

Applies to

See also