LogicalTreeHelper.FindLogicalNode(DependencyObject, String) Metod

Definition

Namnområde:
System.Windows
Sammansättning:
PresentationFramework.dll

Försöker hitta och returnera ett objekt som har det angivna namnet. Sökningen startar från det angivna objektet och fortsätter till undernoder i det logiska trädet.

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

Parametrar

logicalTreeNode
DependencyObject

Objektet som du vill börja söka från. Det här objektet måste vara antingen en FrameworkElement eller en FrameworkContentElement.

elementName
String

Namnet på det objekt som ska hittas.

Returer

DependencyObject

Objektet med matchande namn, om ett hittas; returnerar null om inget matchande namn hittades i det logiska trädet.

Kommentarer

Metoderna FrameworkContentElement.FindName och FrameworkElement.FindName liknar ytligt FindLogicalNode, men fungerar med olika logik:

  • Sökriktningen för FindLogicalNode är mot underordnade objekt (nedåt i trädet); sökriktningen för FindName metoderna är mot överordnade objekt (upp i trädet).

  • Metoderna FindName styrs av begreppet XAML-namnskop. Du FindName garanteras att endast ett objekt i det namnet finns eftersom XAML-namnskop framtvingar unikhet. Däremot FindLogicalNode ignorerar XAML-namnskopet och kan korsa XAML-namnskopgränser under sökningen. Därför finns det ingen garanti för att namnet är unikt elementName när gränserna korsas. Mer information om XAML-namnskop finns i WPF XAML Namescopes.

Gäller för