VisualTreeHelper 클래스

정의

시각적 트리의 노드와 관련된 일반적인 작업을 수행하는 유틸리티 메서드를 제공합니다.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
상속
VisualTreeHelper

예제

다음 예제에서는 시각적 개체의 모든 하위 항목을 열거하는 방법을 보여 줍니다. 이 방법은 시각적 개체 계층 구조의 모든 렌더링 정보를 serialize하려는 경우에 사용할 수 있습니다.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)

지정한 BitmapEffectVisual 값을 반환합니다.Returns the BitmapEffect value for the specified Visual.

GetBitmapEffectInput(Visual)

지정한 BitmapEffectInputVisual 값을 반환합니다.Returns the BitmapEffectInput value for the specified Visual.

GetCacheMode(Visual)

지정된 Visual의 캐시된 표현을 검색합니다.Retrieves the cached representation of the specified Visual.

GetChild(DependencyObject, Int32)

지정한 부모 내의 지정한 컬렉션 인덱스에 있는 자식 시각적 개체를 반환합니다.Returns the child visual object from the specified collection index within a specified parent.

GetChildrenCount(DependencyObject)

지정한 시각적 개체에 포함된 자식 수를 반환합니다.Returns the number of children that the specified visual object contains.

GetClip(Visual)

지정한 Visual의 클립 영역을 Geometry 값으로 반환합니다.Return the clip region of the specified Visual as a Geometry value.

GetContentBounds(Visual)

지정한 Visual에 대한 캐시된 경계 상자 사각형을 반환합니다.Returns the cached bounding box rectangle for the specified Visual.

GetContentBounds(Visual3D)

지정한 Visual3D에 대한 캐시된 경계 상자 사각형을 반환합니다.Returns the cached bounding box rectangle for the specified Visual3D.

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.

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.

GetDpi(Visual)

이 시각적 개체를 측정 및 렌더링하는 DPI 정보를 가져옵니다.Gets the DPI information at which this Visual is measured and rendered.

GetDrawing(Visual)

지정한 Visual의 그리기 내용을 반환합니다.Returns the drawing content of the specified Visual.

GetEdgeMode(Visual)

지정한 Visual의 가장자리 모드를 EdgeMode 값으로 반환합니다.Returns the edge mode of the specified Visual as an EdgeMode value.

GetEffect(Visual)

지정된 Visual에 대한 비트맵 효과를 가져옵니다.Gets the bitmap effect for the specified Visual.

GetOffset(Visual)

Visual의 오프셋을 반환합니다.Returns the offset of the Visual.

GetOpacity(Visual)

Visual의 불투명도를 반환합니다.Returns the opacity of the Visual.

GetOpacityMask(Visual)

Brush의 불투명 마스크를 나타내는 Visual 값을 반환합니다.Returns a Brush value that represents the opacity mask of the Visual.

GetParent(DependencyObject)

시각적 개체의 부모를 나타내는 DependencyObject 값을 반환합니다.Returns a DependencyObject value that represents the parent of the visual object.

GetTransform(Visual)

TransformVisual 값을 반환합니다.Returns a Transform value for the Visual.

GetXSnappingGuidelines(Visual)

X 좌표(세로) 안내선 컬렉션을 반환합니다.Returns an X-coordinate (vertical) guideline collection.

GetYSnappingGuidelines(Visual)

Y 좌표(가로) 안내선 컬렉션을 반환합니다.Returns a Y-coordinate (horizontal) guideline collection.

HitTest(Visual, HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

호출자 정의 HitTestFilterCallbackHitTestResultCallback 메서드를 사용하여 지정된 Visual에서 적중 횟수 테스트를 시작합니다.Initiates a hit test on the specified Visual, with caller-defined HitTestFilterCallback and HitTestResultCallback methods.

HitTest(Visual, Point)

Point를 지정하여 적중 횟수 테스트의 최상위 Visual 개체를 반환합니다.Returns the topmost Visual object of a hit test by specifying a Point.

HitTest(Visual3D, HitTestFilterCallback, HitTestResultCallback, HitTestParameters3D)

호출자 정의 HitTestFilterCallbackHitTestResultCallback 메서드를 사용하여 지정된 Visual3D에서 적중 횟수 테스트를 시작합니다.Initiates a hit test on the specified Visual3D, with caller-defined HitTestFilterCallback and HitTestResultCallback methods.

SetRootDpi(Visual, DpiScale)

시각적 개체의 DPI 정보를 업데이트합니다.Updates the DPI information of a Visual. 부모 없이 시각적 개체에 대해서만 호출될 수 있습니다.It can only be called on a Visual without a parent.

적용 대상