VisualTreeHelper VisualTreeHelper VisualTreeHelper VisualTreeHelper Class

Определение

Предоставляет служебные методы для выполнения типичных задач, связанных с узлами визуального дерева.Provides utility methods that perform common tasks involving nodes in a visual tree.

public ref class VisualTreeHelper abstract sealed
public static class VisualTreeHelper
type VisualTreeHelper = class
Public Class VisualTreeHelper
Наследование
VisualTreeHelperVisualTreeHelperVisualTreeHelperVisualTreeHelper

Примеры

В следующем примере показано, как перечислить всех потомков визуального объекта. Этот метод можно использовать для сериализации всех данных отрисовки в иерархии визуального объекта.The following example shows how to enumerate all the descendants of a visual object, which is a technique you might want to use if you were interested in serializing all the rendering information of a visual object hierarchy.

// 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);
    }
}
' Enumerate all the descendants of the visual object.
Public Shared Sub EnumVisual(ByVal myVisual As Visual)
    For i As Integer = 0 To VisualTreeHelper.GetChildrenCount(myVisual) - 1
        ' Retrieve child visual at specified index value.
        Dim childVisual As Visual = CType(VisualTreeHelper.GetChild(myVisual, i), Visual)

        ' Do processing of the child visual object.

        ' Enumerate children of the child visual object.
        EnumVisual(childVisual)
    Next i
End Sub

Комментарии

Узлы в визуальном дереве могут быть либо Visual Visual3D объектами.Nodes in the visual tree can be either Visual or Visual3D objects. Методы, относящиеся к типу визуального объекта, вводятся как Visual или. Visual3DMethods that are specific to a type of visual object are typed as either Visual or Visual3D. Однако некоторые методы в VisualTreeHelper классе могут DependencyObject принимать значение, представляющее любой из типов визуальных объектов.However, some methods in the VisualTreeHelper class can accept a DependencyObject value that represents either type of visual object.

WPFWPFподдерживает программный доступ к нескольким различным древовидным структурам объектов.supports programmatic access to several different tree structures of objects. В основном это представляет собой визуальное дерево и логическое дерево.Primarily, this is exposed as a visual tree and a logical tree. В некоторых случаях логическое дерево является более полезным представлением элементов в WPFWPF приложении, но концептуально логическое дерево реализуется на уровне, который Visual выходит за пределы класса.In some cases, the logical tree is a more useful representation of the elements in a WPFWPF application, but conceptually the logical tree is implemented at a level beyond the Visual class. В отличие от визуального дерева, логическое дерево может представлять невизуальные объекты данных, такие ListItemкак.Unlike the visual tree, the logical tree can represent nonvisual data objects, such as ListItem. Дополнительные сведения о логическом дереве см. в разделе Деревья в WPF.For more information on the logical tree, see Trees in WPF. Логическое дерево также поддерживается аналогичным классом метода служебной программы, LogicalTreeHelper.The logical tree also is supported by a similar utility method class, LogicalTreeHelper.

Методы

GetBitmapEffect(Visual) GetBitmapEffect(Visual) GetBitmapEffect(Visual) GetBitmapEffect(Visual)

Возвращает значение BitmapEffect для указанного объекта Visual.Returns the BitmapEffect value for the specified Visual.

GetBitmapEffectInput(Visual) GetBitmapEffectInput(Visual) GetBitmapEffectInput(Visual) GetBitmapEffectInput(Visual)

Возвращает значение BitmapEffectInput для указанного объекта Visual.Returns the BitmapEffectInput value for the specified Visual.

GetCacheMode(Visual) GetCacheMode(Visual) GetCacheMode(Visual) GetCacheMode(Visual)

Извлекает кэшированное представление заданного объекта Visual.Retrieves the cached representation of the specified Visual.

GetChild(DependencyObject, Int32) GetChild(DependencyObject, Int32) GetChild(DependencyObject, Int32) GetChild(DependencyObject, Int32)

Возвращает дочерний визуальный объект с заданным индексом в коллекции заданного родительского объекта.Returns the child visual object from the specified collection index within a specified parent.

GetChildrenCount(DependencyObject) GetChildrenCount(DependencyObject) GetChildrenCount(DependencyObject) GetChildrenCount(DependencyObject)

Возвращает число дочерних объектов, содержащихся в заданном визуальном объекте.Returns the number of children that the specified visual object contains.

GetClip(Visual) GetClip(Visual) GetClip(Visual) GetClip(Visual)

Возвращает отсеченную область для заданного Visual как значение Geometry.Return the clip region of the specified Visual as a Geometry value.

GetContentBounds(Visual3D) GetContentBounds(Visual3D) GetContentBounds(Visual3D) GetContentBounds(Visual3D)

Возвращает кэшированный ограничивающий прямоугольник для заданного Visual3D.Returns the cached bounding box rectangle for the specified Visual3D.

GetContentBounds(Visual) GetContentBounds(Visual) GetContentBounds(Visual) GetContentBounds(Visual)

Возвращает кэшированный ограничивающий прямоугольник для заданного Visual.Returns the cached bounding box rectangle for the specified Visual.

GetDescendantBounds(Visual3D) GetDescendantBounds(Visual3D) GetDescendantBounds(Visual3D) GetDescendantBounds(Visual3D)

Возвращает объединение всех ограничивающих прямоугольников содержимого для всех потомков заданного Visual3D, включая ограничивающий прямоугольник содержимого объекта Visual3D.Returns the union of all the content bounding boxes for all the descendants of the specified Visual3D, which includes the content bounding box of the Visual3D.

GetDescendantBounds(Visual) GetDescendantBounds(Visual) GetDescendantBounds(Visual) GetDescendantBounds(Visual)

Возвращает объединение всех ограничивающих прямоугольников содержимого для всех потомков Visual, включая ограничивающий прямоугольник содержимого объекта Visual.Returns the union of all the content bounding boxes for all the descendants of the Visual, which includes the content bounding box of the Visual.

GetDpi(Visual) GetDpi(Visual) GetDpi(Visual) GetDpi(Visual)

Возвращает сведения о DPI для измерения и просмотра этого визуального элемента.Gets the DPI information at which this Visual is measured and rendered.

GetDrawing(Visual) GetDrawing(Visual) GetDrawing(Visual) GetDrawing(Visual)

Возвращает контекст рисования заданного Visual.Returns the drawing content of the specified Visual.

GetEdgeMode(Visual) GetEdgeMode(Visual) GetEdgeMode(Visual) GetEdgeMode(Visual)

Возвращает режим границ заданного объекта Visual как значение EdgeMode.Returns the edge mode of the specified Visual as an EdgeMode value.

GetEffect(Visual) GetEffect(Visual) GetEffect(Visual) GetEffect(Visual)

Возвращает эффект растрового изображения для указанного объекта Visual.Gets the bitmap effect for the specified Visual.

GetOffset(Visual) GetOffset(Visual) GetOffset(Visual) GetOffset(Visual)

Возвращает смещение Visual.Returns the offset of the Visual.

GetOpacity(Visual) GetOpacity(Visual) GetOpacity(Visual) GetOpacity(Visual)

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

GetOpacityMask(Visual) GetOpacityMask(Visual) GetOpacityMask(Visual) GetOpacityMask(Visual)

Возвращает значение Brush, представляющее маску непрозрачности объекта Visual.Returns a Brush value that represents the opacity mask of the Visual.

GetParent(DependencyObject) GetParent(DependencyObject) GetParent(DependencyObject) GetParent(DependencyObject)

Возвращает значение DependencyObject, представляющее родительский объект визуального объекта.Returns a DependencyObject value that represents the parent of the visual object.

GetTransform(Visual) GetTransform(Visual) GetTransform(Visual) GetTransform(Visual)

Возвращает значение Transform для Visual.Returns a Transform value for the Visual.

GetXSnappingGuidelines(Visual) GetXSnappingGuidelines(Visual) GetXSnappingGuidelines(Visual) GetXSnappingGuidelines(Visual)

Возвращает координату x коллекции направляющих (вертикальных).Returns an X-coordinate (vertical) guideline collection.

GetYSnappingGuidelines(Visual) GetYSnappingGuidelines(Visual) GetYSnappingGuidelines(Visual) GetYSnappingGuidelines(Visual)

Возвращает координату y коллекции направляющих (горизонтальных).Returns a Y-coordinate (horizontal) guideline collection.

HitTest(Visual, Point) HitTest(Visual, Point) HitTest(Visual, Point) HitTest(Visual, Point)

Возвращает самый верхний объект Visual для проверки нажатия, указывая Point.Returns the topmost Visual object of a hit test by specifying a Point.

HitTest(Visual3D, HitTestFilterCallback, HitTestResultCallback, HitTestParameters3D) HitTest(Visual3D, HitTestFilterCallback, HitTestResultCallback, HitTestParameters3D) HitTest(Visual3D, HitTestFilterCallback, HitTestResultCallback, HitTestParameters3D) HitTest(Visual3D, HitTestFilterCallback, HitTestResultCallback, HitTestParameters3D)

Инициирует проверку нажатия в указанном Visual3D с помощью определяемых вызывающей стороной методов HitTestFilterCallback и HitTestResultCallback.Initiates a hit test on the specified Visual3D, with caller-defined HitTestFilterCallback and HitTestResultCallback methods.

HitTest(Visual, HitTestFilterCallback, HitTestResultCallback, HitTestParameters) HitTest(Visual, HitTestFilterCallback, HitTestResultCallback, HitTestParameters) HitTest(Visual, HitTestFilterCallback, HitTestResultCallback, HitTestParameters) HitTest(Visual, HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Инициирует проверку нажатия в указанном Visual с помощью определяемых вызывающей стороной методов HitTestFilterCallback и HitTestResultCallback.Initiates a hit test on the specified Visual, with caller-defined HitTestFilterCallback and HitTestResultCallback methods.

SetRootDpi(Visual, DpiScale) SetRootDpi(Visual, DpiScale) SetRootDpi(Visual, DpiScale) SetRootDpi(Visual, DpiScale)

Обновляет сведения о значении DPI визуального элемента.Updates the DPI information of a Visual. Его можно вызывать только для визуального элемента, который не связан с родительским объектом.It can only be called on a Visual without a parent.

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