LogicalTreeHelper.FindLogicalNode(DependencyObject, String) Metoda

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationFramework.dll

Próbuje znaleźć i zwrócić obiekt o określonej nazwie. Wyszukiwanie rozpoczyna się od określonego obiektu i jest kontynuowane w podwęźle drzewa logicznego.

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

Parametry

logicalTreeNode

DependencyObject

Obiekt do rozpoczęcia wyszukiwania. Ten obiekt musi być obiektem FrameworkElement lub .FrameworkContentElement

elementName

String

Nazwa obiektu do znalezienia.

Zwraca

DependencyObject

Obiekt o pasującej nazwie, jeśli zostanie znaleziony; Zwraca wartość null , jeśli nie znaleziono pasującej nazwy w drzewie logicznym.

Uwagi

Metody FrameworkContentElement.FindName i FrameworkElement.FindName są powierzchownie podobne do FindLogicalNode, ale działają według innej logiki:

• Kierunek FindLogicalNode wyszukiwania jest skierowany do obiektów podrzędnych (w dół drzewa); kierunek FindName wyszukiwania metod jest skierowany do obiektów nadrzędnych (w górę drzewa).

• Metody FindName podlegają koncepcji nazwy XAML. Przy użyciu FindName gwarantujesz, że istnieje tylko jeden obiekt tej nazwy, ponieważ nazwy XAML wymuszają unikatowość. FindLogicalNode Natomiast ignoruje zakres nazw XAML i może przekraczać granice zakresu nazw XAML podczas wyszukiwania. W związku z tym nie ma gwarancji unikatowości nazwy po przekroczeniu elementName granic. Aby uzyskać więcej informacji na temat nazw XAML, zobacz WPF XAML Namescopes.