LogicalTreeHelper.FindLogicalNode(DependencyObject, String) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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
FindNamemethoden is richting bovenliggende objecten (omhoog de structuur).De
FindNamemethoden worden bepaald door het concept van een XAML-naamscoop. Met behulp vanFindNameu 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 deelementNamenaam zodra grenzen zijn overschreden. Zie WPF XAML Namescopes voor meer informatie over XAML-naambereiken.