LogicalTreeHelper.FindLogicalNode(DependencyObject, String) Yöntem

Tanım

Ad Alanı:

System.Windows

Bütünleştirilmiş Kod:

PresentationFramework.dll

Belirtilen ada sahip bir nesneyi bulmaya ve döndürmeye çalışır. Arama belirtilen nesneden başlar ve mantıksal ağacın alt düğümlerine devam eder.

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

Parametreler

logicalTreeNode

DependencyObject

Aramaya başlanması gereken nesne. Bu nesne veya FrameworkElement FrameworkContentElementolmalıdır.

elementName

String

Bulunacak nesnenin adı.

Döndürülenler

DependencyObject

Bir nesne bulunursa eşleşen ada sahip nesne; mantıksal ağaçta eşleşen bir ad bulunamazsa döndürür null .

Açıklamalar

ve FrameworkElement.FindName yöntemlerine FrameworkContentElement.FindName yüzeyüstü olarak benzerFindLogicalNode, ancak farklı mantıklarla çalışır:

• için FindLogicalNode arama yönü alt nesnelere (ağaçtan aşağı doğru) yöneliktir; yöntemlerin FindName arama yönü üst nesnelere (ağacın yukarısı) doğru olur.

• Yöntemler, FindName XAML ad kapsamı kavramına tabidir. FindName XAML ad kapsamları benzersizliği zorunlu kıldığı için, bu adın yalnızca bir nesnesinin varolduğu garanti edilir. Buna karşılık, FindLogicalNode XAML ad kapsamını yoksayar ve arama sırasında XAML ad kapsamı sınırlarını aşabilir. Bu nedenle, sınırlar aşıldıktan sonra adın elementName benzersizliğinin garantisi yoktur. XAML ad kapsamları hakkında daha fazla bilgi için bkz. WPF XAML Ad Kapsamları.