VisualTreeHelper Classe

Definizione

public ref class VisualTreeHelper abstract sealed

public static class VisualTreeHelper

type VisualTreeHelper = class

Public Class VisualTreeHelper

Ereditarietà

Object

VisualTreeHelper

Esempio

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.

// 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 . I metodi specifici di un tipo di oggetto visivo vengono digitati come Visual o Visual3D. Tuttavia, alcuni metodi nella VisualTreeHelper classe possono accettare un DependencyObject valore che rappresenta un tipo 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 oltre la Visual classe . A differenza della struttura ad albero visuale, l'albero logico può rappresentare oggetti dati non visivi, ad esempio ListItem. Per altre informazioni sull'albero logico, vedere Strutture ad albero in WPF. L'albero logico è supportato anche da una classe di metodo di utilità simile, LogicalTreeHelper.

Metodi

Si applica a