VisualTreeHelper Classe

Definizione

Spazio dei nomi:

System.Windows.Media

Assembly:

PresentationCore.dll

Fornisce metodi di utilità che eseguono attività comuni che coinvolgono nodi in una struttura ad albero visuale.

public ref class VisualTreeHelper abstract sealed

public static class VisualTreeHelper

type VisualTreeHelper = class

Public Class VisualTreeHelper

Ereditarietà

Object

VisualTreeHelper

Esempio

Nell'esempio seguente viene illustrato come enumerare tutti i discendenti di un oggetto visivo, ovvero una tecnica da usare se si è interessati a serializzare tutte le informazioni di rendering di una gerarchia di oggetti visivi.

// Enumerate all the descendants of the visual object.
public static 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 oggetti o Visual3D . I metodi specifici di un tipo di oggetto visivo vengono tipizzato come Visual o Visual3D. Tuttavia, alcuni metodi nella VisualTreeHelper classe possono accettare un DependencyObject valore che rappresenta uno dei due tipi di oggetto visivo.

WPF supporta l'accesso a livello di codice a diverse strutture ad albero di oggetti. Principalmente, questo viene esposto come albero visivo e un albero logico. In alcuni casi, l'albero logico è una rappresentazione più utile degli elementi in un'applicazione WPF, ma concettualmente l'albero logico viene implementato a un livello superiore alla Visual classe . A differenza della struttura ad albero visuale, l'albero logico può rappresentare oggetti dati nonvisuali, ad esempio ListItem. Per altre informazioni sull'albero logico, vedere Trees in WPF. L'albero logico è supportato anche da una classe di metodi di utilità simile, LogicalTreeHelper.

Metodi

Nome	Descrizione
GetBitmapEffect(Visual)	Restituisce il BitmapEffect valore per l'oggetto specificato Visual.
GetBitmapEffectInput(Visual)	Restituisce il BitmapEffectInput valore per l'oggetto specificato Visual.
GetCacheMode(Visual)	Recupera la rappresentazione memorizzata nella cache dell'oggetto specificato Visual.
GetChild(DependencyObject, Int32)	Restituisce l'oggetto visivo figlio dall'indice dell'insieme specificato all'interno di un elemento padre specificato.
GetChildrenCount(DependencyObject)	Restituisce il numero di elementi figlio contenuti nell'oggetto visivo specificato.
GetClip(Visual)	Restituisce l'area di ritaglio dell'oggetto specificato Visual come Geometry valore.
GetContentBounds(Visual)	Restituisce il rettangolo del riquadro delimitatore memorizzato nella cache per l'oggetto specificato Visual.
GetContentBounds(Visual3D)	Restituisce il rettangolo del riquadro delimitatore memorizzato nella cache per l'oggetto specificato Visual3D.
GetDescendantBounds(Visual)	Restituisce l'unione di tutti i rettangoli di delimitazione del contenuto per tutti i discendenti dell'oggetto Visual, che include il rettangolo di selezione del contenuto dell'oggetto Visual.
GetDescendantBounds(Visual3D)	Restituisce l'unione di tutti i rettangoli di delimitazione del contenuto per tutti i discendenti dell'oggetto specificato Visual3D, che include il rettangolo di selezione del contenuto dell'oggetto Visual3D.
GetDpi(Visual)	Ottiene le informazioni DPI in corrispondenza della quale l'oggetto visivo viene misurato e sottoposto a rendering.
GetDrawing(Visual)	Restituisce il contenuto del disegno dell'oggetto specificato Visual.
GetEdgeMode(Visual)	Restituisce la modalità perimetrale dell'oggetto specificato Visual come EdgeMode valore.
GetEffect(Visual)	Ottiene l'effetto bitmap per l'oggetto specificato Visual.
GetOffset(Visual)	Restituisce l'offset dell'oggetto Visual.
GetOpacity(Visual)	Restituisce l'opacità dell'oggetto Visual.
GetOpacityMask(Visual)	Restituisce un Brush valore che rappresenta la maschera di opacità dell'oggetto Visual.
GetParent(DependencyObject)	Restituisce un DependencyObject valore che rappresenta l'elemento padre dell'oggetto visivo.
GetTransform(Visual)	Restituisce un Transform valore per l'oggetto Visual.
GetXSnappingGuidelines(Visual)	Restituisce una raccolta di linee guida delle coordinate X (verticale).
GetYSnappingGuidelines(Visual)	Restituisce una raccolta di linee guida di coordinate Y (orizzontale).
HitTest(Visual, HitTestFilterCallback, HitTestResultCallback, HitTestParameters)	Avvia un hit test sull'oggetto specificatoVisual, con metodi e HitTestFilterCallback definiti dal HitTestResultCallback chiamante.
HitTest(Visual, Point)	Restituisce l'oggetto più Visual in alto di un hit test specificando un oggetto Point.
HitTest(Visual3D, HitTestFilterCallback, HitTestResultCallback, HitTestParameters3D)	Avvia un hit test sull'oggetto specificatoVisual3D, con metodi e HitTestFilterCallback definiti dal HitTestResultCallback chiamante.
SetRootDpi(Visual, DpiScale)	Aggiorna le informazioni dpi di un oggetto visivo. Può essere chiamato solo in un oggetto Visivo senza un elemento padre.