VisualTreeHelper Classe

Definição

Fornece métodos de utilitário que executam tarefas comuns envolvendo nós em uma árvore 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
Herança
VisualTreeHelper

Exemplos

O exemplo a seguir mostra como enumerar todos os descendentes de um objeto visual, que é uma técnica que talvez você queira usar caso esteja interessado em serializar a informação de renderização de uma hierarquia de objetos visuais.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

Comentários

Os nós na árvore visual podem ser Visual ou Visual3D objetos.Nodes in the visual tree can be either Visual or Visual3D objects. Os métodos que são específicos para um tipo de objeto visual são digitados como Visual ou Visual3D.Methods that are specific to a type of visual object are typed as either Visual or Visual3D. No entanto, alguns métodos na classe VisualTreeHelper podem aceitar um valor de DependencyObject que representa qualquer tipo de objeto visual.However, some methods in the VisualTreeHelper class can accept a DependencyObject value that represents either type of visual object.

o WPFWPF dá suporte ao acesso programático a várias estruturas de árvore diferentes de objetos.WPFWPF supports programmatic access to several different tree structures of objects. Basicamente, isso é exposto como uma árvore visual e uma árvore lógica.Primarily, this is exposed as a visual tree and a logical tree. Em alguns casos, a árvore lógica é uma representação mais útil dos elementos em um aplicativo WPFWPF, mas conceitualmente a árvore lógica é implementada em um nível além da classe 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. Ao contrário da árvore visual, a árvore lógica pode representar objetos de dados não visuais, como ListItem.Unlike the visual tree, the logical tree can represent nonvisual data objects, such as ListItem. Para obter mais informações sobre a árvore lógica, consulte Árvores no WPF.For more information on the logical tree, see Trees in WPF. A árvore lógica também tem suporte por uma classe de método de utilitário semelhante, LogicalTreeHelper.The logical tree also is supported by a similar utility method class, LogicalTreeHelper.

Métodos

GetBitmapEffect(Visual)

Retorna o valor BitmapEffect para o Visual especificado.Returns the BitmapEffect value for the specified Visual.

GetBitmapEffectInput(Visual)

Retorna o valor BitmapEffectInput para o Visual especificado.Returns the BitmapEffectInput value for the specified Visual.

GetCacheMode(Visual)

Recupera a representação armazenada em cache do Visual especificado.Retrieves the cached representation of the specified Visual.

GetChild(DependencyObject, Int32)

Retorna o objeto filho visual do índice de coleção especificado dentro de um pai especificado.Returns the child visual object from the specified collection index within a specified parent.

GetChildrenCount(DependencyObject)

Retorna o número de filhos que o objeto visual especificado contém.Returns the number of children that the specified visual object contains.

GetClip(Visual)

Retorna a região de recorte do Visual especificado como um valor Geometry.Return the clip region of the specified Visual as a Geometry value.

GetContentBounds(Visual)

Retorna o retângulo da caixa delimitadora armazenada em cache para o Visual especificado.Returns the cached bounding box rectangle for the specified Visual.

GetContentBounds(Visual3D)

Retorna o retângulo da caixa delimitadora armazenada em cache para o Visual3D especificado.Returns the cached bounding box rectangle for the specified Visual3D.

GetDescendantBounds(Visual)

Retorna a união de todas as caixas delimitadoras de conteúdo para todos os descendentes do Visual, o que inclui a caixa delimitadora de conteúdo do 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)

Retorna a união de todas as caixas delimitadoras de conteúdo para todos os descendentes do Visual3D especificado, o que inclui a caixa delimitadora de conteúdo do 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)

Obtém as informações de DPI com as quais esse Visual é medido e renderizado.Gets the DPI information at which this Visual is measured and rendered.

GetDrawing(Visual)

Retorna o conteúdo do desenho do Visual especificado.Returns the drawing content of the specified Visual.

GetEdgeMode(Visual)

Retorna o modo de borda do Visual especificado como um valor EdgeMode.Returns the edge mode of the specified Visual as an EdgeMode value.

GetEffect(Visual)

Obtém o efeito de bitmap do Visual especificado.Gets the bitmap effect for the specified Visual.

GetOffset(Visual)

Retorna o deslocamento do Visual.Returns the offset of the Visual.

GetOpacity(Visual)

Retorna a opacidade do Visual.Returns the opacity of the Visual.

GetOpacityMask(Visual)

Retorna um valor Brush que representa a máscara de opacidade do Visual.Returns a Brush value that represents the opacity mask of the Visual.

GetParent(DependencyObject)

Retorna um valor DependencyObject que representa o pai do objeto visual.Returns a DependencyObject value that represents the parent of the visual object.

GetTransform(Visual)

Retorna um valor Transform para o Visual.Returns a Transform value for the Visual.

GetXSnappingGuidelines(Visual)

Retorna uma coleção de diretrizes de coordenada X (vertical).Returns an X-coordinate (vertical) guideline collection.

GetYSnappingGuidelines(Visual)

Retorna uma coleção de diretrizes de coordenada Y (horizontal).Returns a Y-coordinate (horizontal) guideline collection.

HitTest(Visual, HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Inicia um teste de clique no Visual especificado, com métodos HitTestFilterCallback e HitTestResultCallback definidos pelo chamador.Initiates a hit test on the specified Visual, with caller-defined HitTestFilterCallback and HitTestResultCallback methods.

HitTest(Visual, Point)

Retorna o primeiro objeto Visual de um teste de clique especificando um Point.Returns the topmost Visual object of a hit test by specifying a Point.

HitTest(Visual3D, HitTestFilterCallback, HitTestResultCallback, HitTestParameters3D)

Inicia um teste de clique no Visual3D especificado, com métodos HitTestFilterCallback e HitTestResultCallback definidos pelo chamador.Initiates a hit test on the specified Visual3D, with caller-defined HitTestFilterCallback and HitTestResultCallback methods.

SetRootDpi(Visual, DpiScale)

Atualiza as informações de DPI de um Visual.Updates the DPI information of a Visual. Só pode ser chamado em um Visual sem pai.It can only be called on a Visual without a parent.

Aplica-se a