LogicalTreeHelper.FindLogicalNode(DependencyObject, String) Metodo

Definizione

Spazio dei nomi:
System.Windows
Assembly:
PresentationFramework.dll

Tenta di trovare e restituire un oggetto con il nome specificato. La ricerca inizia dall'oggetto specificato e continua in sottonodi dell'albero logico.

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

Parametri

logicalTreeNode
DependencyObject

Oggetto da cui iniziare la ricerca. Questo oggetto deve essere un oggetto FrameworkElement o .FrameworkContentElement

elementName
String

Nome dell'oggetto da trovare.

Valori restituiti

DependencyObject

Oggetto con il nome corrispondente, se ne viene trovato uno; restituisce null se non è stato trovato alcun nome corrispondente nell'albero logico.

Commenti

I metodi FrameworkContentElement.FindName e FrameworkElement.FindName sono superficialmente simili a , ma operano in base a FindLogicalNodelogica diversa:

  • La direzione di ricerca per FindLogicalNode è verso gli oggetti figlio (verso il basso nell'albero); la direzione di ricerca per i metodi è verso gli FindName oggetti padre (verso l'alto l'albero).

  • I FindName metodi sono regolati dal concetto di ambito dei nomi XAML. L'uso FindName di è garantito che esista un solo oggetto di tale nome, perché gli ambiti dei nomi XAML applicano l'univocità. Al contrario, FindLogicalNode ignora l'ambito dei nomi XAML e potrebbe superare i limiti dell'ambito dei nomi XAML durante la ricerca. Di conseguenza, non esiste alcuna garanzia di univocità del elementName nome una volta superati i limiti. Per altre informazioni sugli ambiti dei nomi XAML, vedi macchine virtuali Windows ambiti dei nomi XAML.

Si applica a