Freigeben über


LogicalTreeHelper.FindLogicalNode(DependencyObject, String) Methode

Definition

Versucht, ein Objekt mit dem angegebenen Namen zu suchen und zurückzugeben. Die Suche startet beim angegebenen Objekt und wird in den untergeordneten Knoten der logischen Struktur fortgesetzt.

public:
 static System::Windows::DependencyObject ^ FindLogicalNode(System::Windows::DependencyObject ^ logicalTreeNode, System::String ^ elementName);
public static System.Windows.DependencyObject FindLogicalNode (System.Windows.DependencyObject logicalTreeNode, string elementName);
static member FindLogicalNode : System.Windows.DependencyObject * string -> System.Windows.DependencyObject
Public Shared Function FindLogicalNode (logicalTreeNode As DependencyObject, elementName As String) As DependencyObject

Parameter

logicalTreeNode
DependencyObject

Das Objekt, bei dem die Suche begonnen werden soll. Bei diesem Objekt muss es sich um ein FrameworkElement oder um ein FrameworkContentElement handeln.

elementName
String

Der Name des zu suchenden -Objekts.

Gibt zurück

DependencyObject

Das Objekt mit dem entsprechenden Namen, falls ein solches Element gefunden wird. Gibt null zurück, wenn kein entsprechender Name in der Struktur gefunden wird.

Hinweise

Die Methoden FrameworkContentElement.FindName und FrameworkElement.FindName sind oberflächlich ähnlich wie FindLogicalNode, aber arbeiten sie durch verschiedene Logik:

  • Die Suchrichtung liegt in Richtung FindLogicalNode untergeordneter Objekte (nach unten in der Struktur); die Suchrichtung für die FindName Methoden liegt in Richtung übergeordneter Objekte (nach oben auf der Struktur).

  • Die FindName Methoden werden durch das Konzept eines XAML-Namescopes gesteuert. Mithilfe der Verwendung FindName wird sichergestellt, dass nur ein Objekt dieses Namens vorhanden ist, da XAML-Namescopes eindeutig sind. Ignoriert dagegen FindLogicalNode XAML-Namescope und kann während der Suche XAML-Namescope-Grenzen überschreiten. Daher gibt es keine Garantie für die Eindeutigkeit des elementName Namens, sobald Grenzen überschritten werden. Weitere Informationen zu XAML-Namescopes finden Sie unter WPF-XAML-Namescopes.

Gilt für