Control.GetTemplateChild Method (System.Windows.Controls)

GetTemplateChild Method

Switch on low bandwidth view

Collapse All

Language Filter

.NET Framework Class Library for Silverlight

Control..::.GetTemplateChild Method

Retrieves the named element in the instantiated ControlTemplate visual tree.

Namespace: System.Windows.Controls
Assembly: System.Windows (in System.Windows.dll)

Syntax

Visual Basic (Declaration)

Protected Function GetTemplateChild ( _
    childName As String _
) As DependencyObject

Visual Basic (Usage)

Dim childName As String
Dim returnValue As DependencyObject

returnValue = Me.GetTemplateChild(childName)

protected DependencyObject GetTemplateChild(
    string childName
)

Parameters

childName: Type: System..::.String
The name of element to find.

Return Value

Type: System.Windows..::.DependencyObject
The named element from the template, if found. Can return nullNothingnullptra null reference (Nothing in Visual Basic) if no element with name childName was found in the template.

Remarks

Templates in Silverlight 2 have a self-contained namescope. This is because templates are re-used, and any name defined in a template cannot remain unique once multiple instances of a control each instantiate their template. Call GetTemplateChild in order to return references to objects that come from the template after it is instantiated. You cannot use FindName to find items from templates because FindName acts in a more general scope, and there is no connection between the ControlTemplate class itself and the instantiated template once it is applied.

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Reference

Control Class

Control Members

System.Windows.Controls Namespace