VisualTreeHelper VisualTreeHelper VisualTreeHelper VisualTreeHelper Class

Definición

Proporciona métodos de utilidad que realizan tareas comunes que implican nodos de un árbol visual.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
Herencia
VisualTreeHelperVisualTreeHelperVisualTreeHelperVisualTreeHelper

Ejemplos

En el ejemplo siguiente se muestra cómo enumerar todos los descendientes de un objeto visual, que es una técnica que se puede utilizar si se desea serializar toda la información de representación de una jerarquía de objetos visuales.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

Comentarios

Los nodos del árbol visual pueden ser Visual o Visual3D objetos.Nodes in the visual tree can be either Visual or Visual3D objects. Los métodos que son específicos de un tipo de objeto visual se escriben como Visual o Visual3D.Methods that are specific to a type of visual object are typed as either Visual or Visual3D. Sin embargo, algunos métodos en el VisualTreeHelper clase puede aceptar un DependencyObject valor que representa cualquier tipo de objeto visual.However, some methods in the VisualTreeHelper class can accept a DependencyObject value that represents either type of visual object.

WPFWPF admite el acceso mediante programación a varias diferentes estructuras de árbol de objetos.supports programmatic access to several different tree structures of objects. Principalmente, esto se expone como un árbol visual y un árbol lógico.Primarily, this is exposed as a visual tree and a logical tree. En algunos casos, el árbol lógico es una representación más útil de los elementos de un WPFWPF aplicación, pero conceptualmente el árbol lógico se implementa en un nivel más allá de la Visual clase.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. A diferencia del árbol visual, el árbol lógico puede representar objetos de datos no visuales, tales como ListItem.Unlike the visual tree, the logical tree can represent nonvisual data objects, such as ListItem. Para más información acerca del árbol lógico, consulte Árboles en WPF.For more information on the logical tree, see Trees in WPF. El árbol lógico también es compatible con una clase de método de utilidad similar, LogicalTreeHelper.The logical tree also is supported by a similar utility method class, LogicalTreeHelper.

Métodos

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

Devuelve el valor de BitmapEffect del objeto Visual especificado.Returns the BitmapEffect value for the specified Visual.

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

Devuelve el valor de BitmapEffectInput del objeto Visual especificado.Returns the BitmapEffectInput value for the specified Visual.

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

Recupera la representación en memoria caché del objeto Visual especificado.Retrieves the cached representation of the specified Visual.

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

Devuelve el objeto visual secundario del índice de colección especificado dentro de un elemento primario especificado.Returns the child visual object from the specified collection index within a specified parent.

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

Devuelve el número de elementos secundarios que el objeto visual especificado contiene.Returns the number of children that the specified visual object contains.

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

Devuelve la región de recorte del objeto Visual especificado como un valor de Geometry.Return the clip region of the specified Visual as a Geometry value.

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

Devuelve el rectángulo del cuadro de límite en caché del objeto Visual3D especificado.Returns the cached bounding box rectangle for the specified Visual3D.

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

Devuelve el rectángulo del cuadro de límite en caché del objeto Visual especificado.Returns the cached bounding box rectangle for the specified Visual.

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

Devuelve la unión de todos los cuadros de límite del contenido de todos los descendientes del objeto Visual3D especificado, incluido el rectángulo de selección del contenido del objeto 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)

Devuelve la unión de todos los cuadros de límite del contenido de todos los descendientes del objeto Visual, incluido el rectángulo de selección del contenido del objeto 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)

Obtiene la información de PPP en la que se mide y se representa este objeto visual.Gets the DPI information at which this Visual is measured and rendered.

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

Devuelve el contenido de dibujo del objeto Visual especificado.Returns the drawing content of the specified Visual.

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

Devuelve el modo de borde del objeto Visual especificado como un valor de EdgeMode.Returns the edge mode of the specified Visual as an EdgeMode value.

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

Obtiene el efecto de imagen del objeto Visual especificado.Gets the bitmap effect for the specified Visual.

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

Devuelve el desplazamiento del objeto Visual.Returns the offset of the Visual.

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

Devuelve la opacidad del objeto Visual.Returns the opacity of the Visual.

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

Devuelve un valor de Brush que representa la máscara de opacidad del objeto Visual.Returns a Brush value that represents the opacity mask of the Visual.

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

Devuelve un valor DependencyObject que representa el elemento primario del objeto visual.Returns a DependencyObject value that represents the parent of the visual object.

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

Devuelve un valor de Transform del objeto Visual.Returns a Transform value for the Visual.

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

Devuelve una colección de coordenadas X (eje vertical) como guía.Returns an X-coordinate (vertical) guideline collection.

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

Devuelve una colección de instrucciones de coordenada Y (horizontal).Returns a Y-coordinate (horizontal) guideline collection.

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

Devuelve el objeto Point de nivel superior de una prueba de posicionamiento al especificar un objeto Visual.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)

Inicia una prueba de posicionamiento en el objeto Visual3D, con los métodos HitTestFilterCallback y HitTestResultCallback definidos por el autor de llamada.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)

Inicia una prueba de posicionamiento en el objeto Visual, con los métodos HitTestFilterCallback y HitTestResultCallback definidos por el autor de llamada.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)

Actualiza la información de PPP de un objeto visual.Updates the DPI information of a Visual. Sólo puede llamarse en un elemento visual sin un elemento primario.It can only be called on a Visual without a parent.

Se aplica a