LogicalTreeHelper.FindLogicalNode(DependencyObject, String) LogicalTreeHelper.FindLogicalNode(DependencyObject, String) LogicalTreeHelper.FindLogicalNode(DependencyObject, String) LogicalTreeHelper.FindLogicalNode(DependencyObject, String) Method

定義

指定された名前を持つオブジェクトを検索して返します。Attempts to find and return an object that has the specified name. 検索は指定されたオブジェクトから開始され、論理ツリーのサブノードに続きます。The search starts from the specified object and continues into subnodes of the logical tree.

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 DependencyObject DependencyObject DependencyObject

検索を開始するオブジェクト。The object to start searching from. このオブジェクトは、FrameworkElementFrameworkContentElement のどちらかである必要があります。This object must be either a FrameworkElement or a FrameworkContentElement.

elementName
String String String String

検索するオブジェクトの名前。The name of the object to find.

戻り値

一致する名前が見つかった場合は、その名前を持つオブジェクト。論理ツリー内に一致する名前が見つからなかった場合は、null を返します。The object with the matching name, if one is found; returns null if no matching name was found in the logical tree.

注釈

メソッドFrameworkContentElement.FindNameFrameworkElement.FindNameに表面的に似ていますFindLogicalNodeが別のロジックによって動作します。The methods FrameworkContentElement.FindName and FrameworkElement.FindName are superficially similar to FindLogicalNode, but operate by different logic:

  • 検索の方向FindLogicalNode(ツリー); の下の子オブジェクトの方向の検索の方向、FindNameメソッドが (ツリー) 上の親オブジェクト。The search direction for FindLogicalNode is toward child objects (down the tree); the search direction for the FindName methods is towards parent objects (up the tree).

  • FindNameメソッドは XAML 名前スコープの概念によって管理されます。The FindName methods are governed by the concept of a XAML namescope. 使用してFindNameが 1 つだけを保証する XAML 名前スコープに一意性を強制するため、その名前のオブジェクトが存在します。Using FindName you are guaranteed that only one object of that name exists, because XAML namescopes enforce uniqueness. これに対し、FindLogicalNode検索中に XAML 名前スコープおよび XAML 名前スコープの境界を越えた可能性がありますは無視されます。In contrast, FindLogicalNode ignores XAML namescope and might cross XAML namescope boundaries during the search. そのための一意性の保証はありません、elementName境界を越えると名前を付けます。As such, there is no guarantee of uniqueness of the elementName name once boundaries are crossed. XAML 名前スコープの詳細については、次を参照してください。 WPF XAML 名前スコープします。For more information about XAML namescopes, see WPF XAML Namescopes.

適用対象