Данная статья переведена с помощью средств машинного перевода. Чтобы просмотреть ее на английском языке, установите флажок Английский. Вы также можете просматривать английский текст во всплывающем окне, наводя указатель мыши на переведенный текст.
Перевод
Английский

Класс VisualTreeHelper

 

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

Пространство имен:   System.Windows.Media
Сборка:  PresentationCore (в PresentationCore.dll)

System.Object
  System.Windows.Media.VisualTreeHelper

public static class VisualTreeHelper

ИмяОписание
System_CAPS_pubmethodSystem_CAPS_staticGetBitmapEffect(Visual)

Возвращает BitmapEffect значение для указанного Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetBitmapEffectInput(Visual)

Возвращает BitmapEffectInput значение для указанного Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetCacheMode(Visual)

Получает кэшированный представление указанного Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetChild(DependencyObject, Int32)

Возвращает дочерний визуальный объект с заданным индексом в коллекции заданного родительского объекта.

System_CAPS_pubmethodSystem_CAPS_staticGetChildrenCount(DependencyObject)

Возвращает число дочерних объектов, содержащих заданного визуального объекта.

System_CAPS_pubmethodSystem_CAPS_staticGetClip(Visual)

Вернуть отсеченную область указанного Visual как Geometry значение.

System_CAPS_pubmethodSystem_CAPS_staticGetContentBounds(Visual)

Возвращает кэшированный прямоугольную рамку для указанного Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetContentBounds(Visual3D)

Возвращает кэшированный прямоугольную рамку для указанного Visual3D.

System_CAPS_pubmethodSystem_CAPS_staticGetDescendantBounds(Visual)

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

System_CAPS_pubmethodSystem_CAPS_staticGetDescendantBounds(Visual3D)

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

System_CAPS_pubmethodSystem_CAPS_staticGetDpi(Visual)

Возвращает сведения о DPI измеряется и подготовке к просмотру этого визуального элемента.

System_CAPS_pubmethodSystem_CAPS_staticGetDrawing(Visual)

Возвращает содержимое рисунка указанного Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetEdgeMode(Visual)

Возвращает указанный режим edge Visual как EdgeMode значение.

System_CAPS_pubmethodSystem_CAPS_staticGetEffect(Visual)

Возвращает эффект точечного рисунка для указанного Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetOffset(Visual)

Возвращает смещение Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetOpacity(Visual)

Возвращает прозрачность Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetOpacityMask(Visual)

Возвращает Brush значение, представляющее маски непрозрачности Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetParent(DependencyObject)

Возвращает значение DependencyObject, представляющее родительский объект визуального объекта.

System_CAPS_pubmethodSystem_CAPS_staticGetTransform(Visual)

Возвращает Transform значение Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetXSnappingGuidelines(Visual)

Возвращает коллекцию направляющих по оси X (по вертикали).

System_CAPS_pubmethodSystem_CAPS_staticGetYSnappingGuidelines(Visual)

Возвращает коллекцию горизонтальных направляющих (по оси Y).

System_CAPS_pubmethodSystem_CAPS_staticHitTest(Visual, HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Инициирует проверку нажатия в указанном Visual с помощью определяемых вызывающей стороной методов HitTestFilterCallback и HitTestResultCallback.

System_CAPS_pubmethodSystem_CAPS_staticHitTest(Visual, Point)

Возвращает самый верхний объект Visual для проверки нажатия, указывая Point.

System_CAPS_pubmethodSystem_CAPS_staticHitTest(Visual3D, HitTestFilterCallback, HitTestResultCallback, HitTestParameters3D)

Инициирует проверку нажатия в указанном Visual3D с помощью определяемых вызывающей стороной методов HitTestFilterCallback и HitTestResultCallback.

System_CAPS_pubmethodSystem_CAPS_staticSetRootDpi(Visual, DpiScale)

Обновляет сведения о DPI визуального элемента. Он может вызываться только визуальный элемент без родительского элемента.

Узлы в визуальном дереве может быть либо Visual или Visual3D объектов. Методы, которые относятся к типу визуальный объект типизированы как Visual или Visual3D. Тем не менее некоторые методы в VisualTreeHelper класс может принимать DependencyObject значение, представляющее визуальный объект любого типа.

WPF поддерживает программный доступ к нескольким разным древовидным структурам объектов. В первую очередь оно предоставляется как визуальное дерево и логическое дерево. В некоторых случаях логическое дерево является более полезным представлением элементов в WPF приложение, но концептуально логическое дерево реализовано на уровне, Visual класс. В отличие от визуального дерева, логическое дерево может представлять невизуальных данных объектов, таких как ListItem. Дополнительные сведения о логическом дереве см. в разделе деревья в WPF. Логическое дерево также поддерживается аналогичный метод служебный класс LogicalTreeHelper.

В следующем примере показано, как перечислить всех потомков визуального объекта, который представляет метод, который можно использовать в случае сериализовать всю информацию отрисовки иерархии визуальных объектов.

// Enumerate all the descendants of the visual object.
static public void EnumVisual(Visual myVisual)
{
    for (int i = 0; i < VisualTreeHelper.GetChildrenCount(myVisual); i++)
    {
        // Retrieve child visual at specified index value.
        Visual childVisual = (Visual)VisualTreeHelper.GetChild(myVisual, i);

        // Do processing of the child visual object.

        // Enumerate children of the child visual object.
        EnumVisual(childVisual);
    }
}

.NET Framework
Доступно с 3.0
Silverlight
Доступно с 2.0
Windows Phone Silverlight
Доступно с 7.0

Любые открытые статические элементы ( Предоставлен общий доступ в Visual Basic) этого типа являются потокобезопасными. Потокобезопасность элементов экземпляров не гарантируется.

Вернуться в начало
Показ: