FrameworkElement.TemplatedParent Właściwość

Definicja

Pobiera odwołanie do elementu nadrzędnego szablonu tego elementu.Gets a reference to the template parent of this element. Ta właściwość nie jest istotna, jeśli element nie został utworzony za pomocą szablonu.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

Wartość właściwości

Element, którego FrameworkTemplateVisualTree spowodowała utworzenie tego elementu.The element whose FrameworkTemplateVisualTree caused this element to be created. Ta wartość jest często null.This value is frequently null.

Uwagi

TemplatedParent jest często null dla obiektów tworzonych w znacznikach lub kodzie aplikacji.TemplatedParent is frequently null for objects that are created in your application markup or code. Jest to spowodowane tym, że te obiekty są tworzone bezpośrednio, a nie za pośrednictwem szablonu.This is because you create those objects directly, not via a template. Odwołania do obiektów uzyskane przez przeprowadzenie przechodzenia drzewa logicznego z katalogu głównego lub według typowych odwołań do nazw nie pochodzą z szablonu.Object references obtained by walking the logical tree from the root, or by typical name references, do not come from a template.

Przypadki, w których TemplatedParent mogą nie być null obejmują operacje, takie jak testowanie trafień, obsługa zdarzeń dla pewnych zdarzeń wejściowych niskiego poziomu, przechodzenie drzewa wizualnego z VisualTreeHelperlub praca z modułami wyliczającymi, które mogą zwracać elementy, które pochodzą z szablonów.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. Innym przypadkiem jest to, że w przypadku wywołania FindName z istniejącym FrameworkTemplate i pracy z zwróconym obiektem.Another case is if you specifically call FindName against an existing FrameworkTemplate and are work with the returned object.

Szablony są faktycznie udostępnionymi obiektami, gdzie zawartość szablonu jest tworzona tylko raz.Templates are actually shared objects, where the contents of the template are created only once. W związku z tym, Jeśli uzyskujesz odwołanie do obiektu, który pochodzi z szablonu, może się okazać, że jawne Drzewo logiczne nie dociera do głównego elementu strony.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. Aby połączyć takie odwołanie szablonu z drzewem logicznym strony, należy uzyskać TemplatedParent wartość i kontynuować nawigowanie w drzewie elementów zgodnie z potrzebami.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.

Dotyczy