VisualTreeHelper Klasse

Definition

public ref class VisualTreeHelper abstract sealed

public static class VisualTreeHelper

type VisualTreeHelper = class

Public Class VisualTreeHelper

Vererbung

Object

VisualTreeHelper

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie alle Nachfolgerelemente eines visuellen Objekts auflisten. Diese Methode können Sie verwenden, wenn Sie alle Renderinginformationen einer Hierarchie von visuellen Objekten serialisieren möchten.

// 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

Hinweise

Knoten in der visuellen Struktur können objekte Visual oder Visual3D sein. Methoden, die für einen Typ von visuellen Objekten spezifisch sind, werden entweder Visual als oder Visual3Dtypisiert. Einige Methoden in der VisualTreeHelper -Klasse können jedoch einen Wert akzeptieren, der beide DependencyObject Arten von visuellen Objekten darstellt.

WPF unterstützt den programmgesteuerten Zugriff auf verschiedene Strukturstrukturen von Objekten. In erster Linie wird dies als visuelle Struktur und als logische Struktur verfügbar gemacht. In einigen Fällen ist die logische Struktur eine nützlichere Darstellung der Elemente in einer WPF-Anwendung, aber die logische Struktur wird konzeptionell auf einer Ebene über die Visual -Klasse hinaus implementiert. Im Gegensatz zur visuellen Struktur kann die logische Struktur nichtvisuale Datenobjekte darstellen, z ListItem. B. . Weitere Informationen zu der logischen Struktur finden Sie unter Strukturen in WPF. Die logische Struktur wird auch von einer ähnlichen Hilfsprogrammmethodenklasse unterstützt, LogicalTreeHelper.

Methoden

Gilt für: