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 или Visual3D.Methods 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.

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