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

Définition

Tente de rechercher et de retourner un objet qui a le nom spécifié.Attempts to find and return an object that has the specified name. La recherche démarre à partir de l'objet spécifié et continue dans les sous-nœuds de l'arborescence logique.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

Paramètres

logicalTreeNode
DependencyObject DependencyObject DependencyObject DependencyObject

Objet à partir duquel commencer la recherche.The object to start searching from. Cet objet doit être un type FrameworkElement ou FrameworkContentElement.This object must be either a FrameworkElement or a FrameworkContentElement.

elementName
String String String String

Nom de l'objet à rechercher.The name of the object to find.

Retours

Objet avec le nom correspondant, si la recherche aboutit ; retourne null si aucun nom correspondant n'a été trouvé dans l'arborescence logique.The object with the matching name, if one is found; returns null if no matching name was found in the logical tree.

Remarques

Les méthodes FrameworkContentElement.FindName et FrameworkElement.FindName sont en apparence similaire à FindLogicalNode, mais fonctionnent par logique différente :The methods FrameworkContentElement.FindName and FrameworkElement.FindName are superficially similar to FindLogicalNode, but operate by different logic:

  • Le sens de la recherche pour FindLogicalNode est vers les objets enfants (dans l’arborescence) ; le sens de la recherche pour le FindName méthodes trouve vers les objets parents (vers le haut l’arborescence).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).

  • Le FindName méthodes sont régies par le concept d’une portée de nom XAML.The FindName methods are governed by the concept of a XAML namescope. À l’aide de FindName vous êtes assuré qu’un seul objet de ce nom existe, car les portées de nom XAML l’unicité.Using FindName you are guaranteed that only one object of that name exists, because XAML namescopes enforce uniqueness. En revanche, FindLogicalNode ignore la portée de nom XAML et peut traverser les limites de portée de nom XAML pendant la recherche.In contrast, FindLogicalNode ignores XAML namescope and might cross XAML namescope boundaries during the search. Par conséquent, il n’existe aucune garantie d’unicité de la elementName nom une fois que les limites sont traversées.As such, there is no guarantee of uniqueness of the elementName name once boundaries are crossed. Pour plus d’informations sur les portées de nom XAML, consultez portées de nom XAML WPF.For more information about XAML namescopes, see WPF XAML Namescopes.

S’applique à