Share via


LogicalTreeHelper.FindLogicalNode(DependencyObject, String) 方法

定義

嘗試尋找並傳回具有指定之名稱的物件。 搜尋將從指定的物件開始,並持續至邏輯樹狀結構的子節點。

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

參數

logicalTreeNode
DependencyObject

做為搜尋起點的物件。 這個物件必須是 FrameworkElementFrameworkContentElement

elementName
String

要尋找之物件的名稱。

傳回

DependencyObject

具有相符名稱的物件 (如果找到的話)。如果在邏輯樹狀結構中找不到相符名稱,則傳回 null

備註

和 的方法 FrameworkContentElement.FindName FrameworkElement.FindName FindLogicalNode 與 類似,但由不同的邏輯操作:

  • 的搜尋方向 FindLogicalNode 是指向樹狀結構) (子物件;方法的 FindName 搜尋方向是指向樹狀結構) (父物件。

  • 方法 FindName 是由 XAML 命名範圍的概念所控管。 使用 FindName 可確保只有一個該名稱的物件存在,因為 XAML 名稱範圍會強制執行唯一性。 相反地, FindLogicalNode 忽略 XAML 名稱範圍,而且可能會在搜尋期間跨越 XAML 名稱範圍界限。 因此,一旦跨越界限, elementName 就不保證名稱的唯一性。 如需 XAML 名稱範圍的詳細資訊,請參閱 WPF XAML Namescopes

適用於