FrameworkElement.TemplatedParent Propriedade

Definição

Obtém uma referência ao pai do modelo desse elemento.Gets a reference to the template parent of this element. Essa propriedade não é relevante se o elemento não foi criado por meio de um modelo.This property is not relevant if the element was not created through a template.

public:
 property System::Windows::DependencyObject ^ TemplatedParent { System::Windows::DependencyObject ^ get(); };
public System.Windows.DependencyObject TemplatedParent { get; }
member this.TemplatedParent : System.Windows.DependencyObject
Public ReadOnly Property TemplatedParent As DependencyObject

Valor da propriedade

O elemento cujo FrameworkTemplateVisualTree fez com que esse elemento fosse criado.The element whose FrameworkTemplateVisualTree caused this element to be created. Esse valor costuma ser null.This value is frequently null.

Comentários

TemplatedParent é frequentemente null para objetos que são criados em sua marcação de aplicativo ou código.TemplatedParent is frequently null for objects that are created in your application markup or code. Isso ocorre porque você cria esses objetos diretamente, não por meio de um modelo.This is because you create those objects directly, not via a template. Referências de objeto obtidas percorrendo a árvore lógica da raiz, ou por referências de nome típicas, não são provenientes de um modelo.Object references obtained by walking the logical tree from the root, or by typical name references, do not come from a template.

Casos em que TemplatedParent pode não ser null incluir operações como testes de ocorrências, manipulação de eventos para determinados eventos de entrada de nível baixo, movimentação da árvore visual com VisualTreeHelperou trabalho com enumeradores, que podem retornar elementos provenientes de modelos.Cases where TemplatedParent might not be null include operations such as hit-testing, event handling for certain low-level input events, walking the visual tree with VisualTreeHelper, or working with enumerators, which might return elements that came from templates. Outro caso é se você chama especificamente FindName em relação a um FrameworkTemplate existente e trabalha com o objeto retornado.Another case is if you specifically call FindName against an existing FrameworkTemplate and are work with the returned object.

Os modelos são, na verdade, objetos compartilhados, nos quais o conteúdo do modelo é criado apenas uma vez.Templates are actually shared objects, where the contents of the template are created only once. Portanto, se você obtiver uma referência de objeto para um elemento proveniente de um modelo, poderá descobrir que a árvore lógica aparente não chega à raiz da página.Therefore, if you obtain an object reference to an element that came from a template, you may find that the apparent logical tree does not reach to the page root. Para conectar tal referência de modelo à árvore lógica da página, você deve obter o valor TemplatedParent e continuar a navegar pela árvore de elementos conforme desejado.In order to connect such a template reference to the page's logical tree, you should get the TemplatedParent value and continue to navigate that element tree as desired.

Aplica-se a