LogicalTreeHelper.FindLogicalNode(DependencyObject, String) Método

Definição

Espaço de Nomes:
System.Windows
Assemblagem:
PresentationFramework.dll

Tenta encontrar e devolver um objeto que tenha o nome especificado. A pesquisa começa no objeto especificado e continua para os 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 de onde começar a procurar. Este objeto deve ser ou a FrameworkElement ou um FrameworkContentElement.

elementName
String

O nome do objeto a encontrar.

Devoluções

DependencyObject

O objeto com o nome correspondente, se for encontrado; retorna null se não for encontrado nenhum nome correspondente na árvore lógica.

Observações

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

  • A direção de pesquisa para FindLogicalNode é para objetos filhos (ao longo da árvore); a direção de pesquisa para os FindName métodos é para os objetos pais (acima na árvore).

  • Os FindName métodos são regidos pelo conceito de namescope XAML. Ao usar FindName you, é garantido que existe apenas um objeto com esse nome, porque os namescopes XAML impõem unicidade. Em contraste, FindLogicalNode ignora o namescope do XAML e pode ultrapassar os limites do namescope do XAML durante a pesquisa. Assim, não há garantia de unicidade do elementName nome uma vez que os limites são ultrapassados. Para mais informações sobre namescopes XAML, veja WPF XAML Namescopes.

Aplica-se a