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 comincia dall'oggetto specificato e continua con i nodi secondari 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 cominciare la ricerca. Questo oggetto deve essere un tipo FrameworkElement oppure FrameworkContentElement.

elementName

String

Nome dell'oggetto da trovare.

Restituisce

DependencyObject

Oggetto con il nome corrispondente, se viene trovato; restituisce null se nessun nome corrispondente viene trovato 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 FindName metodi è verso gli oggetti padre (verso l'alto l'albero).

• I FindName metodi sono regolati dal concetto di ambito dei nomi XAML. L'uso FindName garantisce che esista un solo oggetto di tale nome, perché gli ambiti dei nomi XAML impongono l'univocità. Al contrario, FindLogicalNode ignora l'ambito dei nomi XAML e potrebbe attraversare 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, vedere Ambiti dei nomi XAML WPF.