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
Имя искомого объекта.
Возвращаемое значение
Объект с соответствующим именем (в случае нахождения); значение null
, если соответствующее имя в логическом дереве не обнаружено.
Комментарии
Методы и FrameworkElement.FindName поверхностно похожи на FindLogicalNodeметодыFrameworkContentElement.FindName, но работают с другой логикой:
Направление поиска — к дочерним объектам (вниз по дереву); направление
FindName
поиска FindLogicalNode методов — к родительским объектам (вверх по дереву).Методы
FindName
управляются понятием области имен XAML. ИспользованиеFindName
гарантируется, что существует только один объект этого имени, так как области имен XAML обеспечивают уникальность. Напротив, FindLogicalNode игнорирует область имен XAML и может пересекать границы области имен XAML во время поиска. Таким образом, нет гарантии уникальностиelementName
имени после пересечения границ. Дополнительные сведения о областях имен XAML см. в разделе областей имен WPF XAML.