VisualTreeHelper Classe

Definizione

Implementa metodi di utilità che eseguono attività comuni che interessano i nodi in un struttura ad albero visuale.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
Ereditarietà
VisualTreeHelper

Esempi

L'esempio seguente illustra come enumerare tutti i discendenti di un oggetto visivo. Si tratta di una tecnica da usare se si desidera serializzare tutte le informazioni di rendering di una gerarchia di oggetti visivi.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

Commenti

I nodi nella struttura ad albero visuale possono essere Visual o Visual3D oggetti.Nodes in the visual tree can be either Visual or Visual3D objects. I metodi specifici di un tipo di oggetto visivo sono tipizzati come Visual o Visual3D.Methods that are specific to a type of visual object are typed as either Visual or Visual3D. Tuttavia, alcuni metodi della classe VisualTreeHelper possono accettare un valore DependencyObject che rappresenta uno dei tipi di oggetti visivi.However, some methods in the VisualTreeHelper class can accept a DependencyObject value that represents either type of visual object.

WPFWPF supporta l'accesso a livello di codice a diverse strutture ad albero diverse di oggetti.supports programmatic access to several different tree structures of objects. Principalmente, questo viene esposto come una struttura ad albero visuale e un albero logico.Primarily, this is exposed as a visual tree and a logical tree. In alcuni casi, l'albero logico è una rappresentazione più utile degli elementi in un'applicazione WPFWPF, ma concettualmente l'albero logico viene implementato a un livello superiore rispetto alla 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. A differenza della struttura ad albero visuale, l'albero logico può rappresentare oggetti dati non visivi, ad esempio ListItem.Unlike the visual tree, the logical tree can represent nonvisual data objects, such as ListItem. Per altre informazioni sull'albero logico, vedere Strutture ad albero in WPF.For more information on the logical tree, see Trees in WPF. L'albero logico è inoltre supportato da una classe di metodi di utilità simile, LogicalTreeHelper.The logical tree also is supported by a similar utility method class, LogicalTreeHelper.

Metodi

GetBitmapEffect(Visual)

Restituisce il valore BitmapEffect per l'oggetto Visual specificato.Returns the BitmapEffect value for the specified Visual.

GetBitmapEffectInput(Visual)

Restituisce il valore BitmapEffectInput per l'oggetto Visual specificato.Returns the BitmapEffectInput value for the specified Visual.

GetCacheMode(Visual)

Recupera la rappresentazione memorizzata nella cache dell'oggetto Visual specificato.Retrieves the cached representation of the specified Visual.

GetChild(DependencyObject, Int32)

Restituisce l'oggetto visivo figlio in base all'indice dell'insieme specificato all'interno di un determinato oggetto padre.Returns the child visual object from the specified collection index within a specified parent.

GetChildrenCount(DependencyObject)

Restituisce il numero di oggetti figlio contenuti nell'oggetto visivo specificato.Returns the number of children that the specified visual object contains.

GetClip(Visual)

Restituisce l'area di ridimensionamento dell'oggetto Visual specificato sotto forma di valore Geometry.Return the clip region of the specified Visual as a Geometry value.

GetContentBounds(Visual)

Restituisce il rettangolo del riquadro delimitatore del testo memorizzato nella cache per l'oggetto Visual specificato.Returns the cached bounding box rectangle for the specified Visual.

GetContentBounds(Visual3D)

Restituisce il rettangolo del riquadro delimitatore del testo memorizzato nella cache per l'oggetto Visual3D specificato.Returns the cached bounding box rectangle for the specified Visual3D.

GetDescendantBounds(Visual)

Restituisce l'unione di tutti i riquadri delimitatori del contenuto per tutti i discendenti dell'oggetto Visual, incluso il riquadro delimitatore del contenuto dell'oggetto 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)

Restituisce l'unione di tutti i riquadri delimitatori del contenuto per tutti i discendenti dell'oggetto Visual3Dspecificato, incluso il riquadro delimitatore del contenuto dell'oggetto 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)

Ottiene le informazioni DPI in base a cui l'oggetto Visual viene misurato e viene eseguito il rendering.Gets the DPI information at which this Visual is measured and rendered.

GetDrawing(Visual)

Restituisce il contenuto del disegno dell'oggetto Visual specificato.Returns the drawing content of the specified Visual.

GetEdgeMode(Visual)

Restituisce la modalità di bordo dell'oggetto Visual specificato come valore EdgeMode.Returns the edge mode of the specified Visual as an EdgeMode value.

GetEffect(Visual)

Ottiene un effetto bitmap per l'istanza di Visual specificata.Gets the bitmap effect for the specified Visual.

GetOffset(Visual)

Restituisce l'offset dell'oggetto Visual.Returns the offset of the Visual.

GetOpacity(Visual)

Restituisce l'opacità dell'oggetto Visual.Returns the opacity of the Visual.

GetOpacityMask(Visual)

Restituisce un valore Brush che rappresenta la maschera di opacità dell'oggetto Visual.Returns a Brush value that represents the opacity mask of the Visual.

GetParent(DependencyObject)

Restituisce un valore DependencyObject che rappresenta l'elemento padre dell'oggetto visivo.Returns a DependencyObject value that represents the parent of the visual object.

GetTransform(Visual)

Restituisce un valore Transform per l'oggetto Visual.Returns a Transform value for the Visual.

GetXSnappingGuidelines(Visual)

Restituisce una raccolta delle linee guida per la coordinata x (verticale).Returns an X-coordinate (vertical) guideline collection.

GetYSnappingGuidelines(Visual)

Restituisce una raccolta delle linee guida per la coordinata Y (orizzontale).Returns a Y-coordinate (horizontal) guideline collection.

HitTest(Visual, HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Avvia un hit test sull'oggetto Visual specificato, con metodi HitTestFilterCallback e HitTestResultCallback definiti dal chiamante.Initiates a hit test on the specified Visual, with caller-defined HitTestFilterCallback and HitTestResultCallback methods.

HitTest(Visual, Point)

Restituisce l'oggetto Visual in primo piano di un hit test specificando Point.Returns the topmost Visual object of a hit test by specifying a Point.

HitTest(Visual3D, HitTestFilterCallback, HitTestResultCallback, HitTestParameters3D)

Avvia un hit test sull'oggetto Visual3D specificato, con metodi HitTestFilterCallback e HitTestResultCallback definiti dal chiamante.Initiates a hit test on the specified Visual3D, with caller-defined HitTestFilterCallback and HitTestResultCallback methods.

SetRootDpi(Visual, DpiScale)

Aggiorna le informazioni sulla scala DPI di un elemento visivo.Updates the DPI information of a Visual. Può essere chiamato solo su un elemento visivo senza un padre.It can only be called on a Visual without a parent.

Si applica a