LogicalTreeHelper.FindLogicalNode(DependencyObject, String) Метод

Определение

Пытается найти и возвратить объект с заданным именем. Поиск начинается с заданного объекта, после чего переходит в подузлы логического дерева.

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

Параметры

logicalTreeNode
DependencyObject

Объект, с которого должен начаться поиск. Этот объект должен принадлежать к типу FrameworkElement или FrameworkContentElement.

elementName
String

Имя искомого объекта.

Возвращаемое значение

DependencyObject

Объект с соответствующим именем (в случае нахождения); значение null, если соответствующее имя в логическом дереве не обнаружено.

Комментарии

Методы и FrameworkElement.FindName поверхностно похожи на FindLogicalNodeметодыFrameworkContentElement.FindName, но работают с другой логикой:

  • Направление поиска — к дочерним объектам (вниз по дереву); направление FindName поиска FindLogicalNode методов — к родительским объектам (вверх по дереву).

  • Методы FindName управляются понятием области имен XAML. Использование FindName гарантируется, что существует только один объект этого имени, так как области имен XAML обеспечивают уникальность. Напротив, FindLogicalNode игнорирует область имен XAML и может пересекать границы области имен XAML во время поиска. Таким образом, нет гарантии уникальности elementName имени после пересечения границ. Дополнительные сведения о областях имен XAML см. в разделе областей имен WPF XAML.

Применяется к