Classe VisualTreeHelper (System.Windows.Media)

I nodi della struttura ad albero visuale possono essere oggetti Visual o Visual3D. I metodi specifici di un tipo di oggetto visivo sono tipizzati come Visual o Visual3D. Alcuni metodi disponibili nella classe VisualTreeHelper possono tuttavia accettare un valore DependencyObject che rappresenta entrambi i tipi di oggetto visivo.

WPF supporta l'accesso a livello di codice a più strutture ad albero degli oggetti. Un oggetto viene principalmente esposto come struttura ad albero visuale e albero logico. In alcuni casi l'albero logico costituisce una rappresentazione più utile degli elementi in un'applicazione WPF, ma concettualmente viene implementato a un livello superiore rispetto alla classe Visual. A differenza della struttura ad albero visuale, l'albero logico può rappresentare oggetti dati non visivi, ad esempio ListItem. Per ulteriori informazioni sull'albero logico, vedere Trees in WPF. L'albero logico è supportato inoltre da una classe di metodi di utilità simile, ovvero LogicalTreeHelper.

Nell'esempio riportato di seguito viene illustrato come enumerare tutti i discendenti di un oggetto visivo. Si tratta di una tecnica che può risultare utile se si desidera serializzare tutte le informazioni di rendering relative a una gerarchia di oggetti visivi.

		' 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

// 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);
    }
}

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

Riferimenti

Altre risorse