Partager via


LogicalTreeHelper.FindLogicalNode(DependencyObject, String) Méthode

Définition

Tente de rechercher et de retourner un objet qui a le nom spécifié. La recherche démarre à partir de l'objet spécifié et continue dans les sous-nœuds de l'arborescence logique.

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

Objet à partir duquel commencer la recherche. Cet objet doit être un type FrameworkElement ou FrameworkContentElement.

elementName
String

Nom de l'objet à rechercher.

Retours

DependencyObject

Objet avec le nom correspondant, si la recherche aboutit ; retourne null si aucun nom correspondant n'a été trouvé dans l'arborescence logique.

Remarques

Les méthodes FrameworkContentElement.FindName et FrameworkElement.FindName sont superficiellement similaires à FindLogicalNode, mais fonctionnent par une logique différente :

  • La direction FindLogicalNode de recherche est vers les objets enfants (vers le bas de l’arborescence); la direction de recherche des méthodes est vers les FindName objets parents (vers le haut de l’arborescence).

  • Les FindName méthodes sont régies par le concept d’un namescope XAML. L’utilisation FindName de vous garantit qu’un seul objet de ce nom existe, car les portées de noms XAML appliquent l’unicité. En revanche, FindLogicalNode ignore la portée de noms XAML et peut traverser les limites de la portée de noms XAML pendant la recherche. Par conséquent, il n’existe aucune garantie d’unicité du elementName nom une fois que les limites sont croisées. Pour plus d’informations sur les portées de noms XAML, consultez les portées de noms XAML WPF.

S’applique à