LogicalTreeHelper.FindLogicalNode(DependencyObject, String) Método

Definição

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Tenta localizar e retornar um objeto que tem o nome especificado. A pesquisa começa do objeto especificado e continua em subnós da árvore lógica.

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

Parâmetros

logicalTreeNode

DependencyObject

O objeto do qual a pesquisa se inicia. Este objeto deve ser um FrameworkElement ou FrameworkContentElement.

elementName

String

O nome do objeto a ser encontrado.

Retornos

DependencyObject

O objeto com o nome correspondente, caso seja encontrado; retorna null se nenhum nome correspondente foi encontrado na árvore lógica.

Comentários

Os métodos FrameworkContentElement.FindName são FrameworkElement.FindName superficialmente semelhantes a FindLogicalNode, mas operam por lógica diferente:

• A direção da pesquisa FindLogicalNode é em direção a objetos filho (abaixo da árvore); a direção de pesquisa dos FindName métodos é para objetos pai (acima da árvore).

• Os FindName métodos são regidos pelo conceito de um namescope XAML. O uso FindName de você tem a garantia de que existe apenas um objeto desse nome, pois os namescopes XAML impõem exclusividade. Por outro lado, FindLogicalNode ignora o namescope XAML e pode cruzar limites de namescope XAML durante a pesquisa. Dessa forma, não há garantia de exclusividade do nome depois que os elementName limites são cruzados. Para obter mais informações sobre namescopes XAML, consulte Namescopes XAML do WPF.