LogicalTreeHelper.FindLogicalNode(DependencyObject, String) Methode

Definitie

Hiermee wordt geprobeerd een object met de opgegeven naam te zoeken en te retourneren. De zoekopdracht begint met het opgegeven object en gaat verder in subknooppunten van de logische structuur.

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

Parameters

logicalTreeNode
DependencyObject

Het object waaruit moet worden gezocht. Dit object moet een FrameworkElement of een FrameworkContentElement.

elementName
String

De naam van het object dat moet worden gevonden.

Retouren

Het object met de overeenkomende naam, als deze wordt gevonden; retourneert null als er geen overeenkomende naam is gevonden in de logische structuur.

Opmerkingen

De methoden FrameworkContentElement.FindName en FrameworkElement.FindName zijn oppervlakkig vergelijkbaar met FindLogicalNode, maar werken met verschillende logica:

  • De zoekrichting FindLogicalNode is gericht op onderliggende objecten (omlaag in de structuur); de zoekrichting voor de FindName methoden is richting bovenliggende objecten (omhoog de structuur).

  • De FindName methoden worden bepaald door het concept van een XAML-naamscoop. Met behulp van FindName u bent gegarandeerd dat er slechts één object van die naam bestaat, omdat XAML-naamscopen uniekheid afdwingen. Negeert daarentegen FindLogicalNode de XAML-naamscoop en kan XAML-naamscopegrenzen overschrijden tijdens de zoekopdracht. Als zodanig is er geen garantie voor uniekheid van de elementName naam zodra grenzen zijn overschreden. Zie WPF XAML Namescopes voor meer informatie over XAML-naambereiken.

Van toepassing op