VisualTreeHelper Klasse

Definition

Namespace:

System.Windows.Media

Assembly:

PresentationCore.dll

Stellt Dienstprogrammmethoden für allgemeine Aufgaben bereit, die sich auf Knoten in einer visuellen Struktur auswirken.

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

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

GetBitmapEffect(Visual)	Gibt den BitmapEffect-Wert für das angegebene Visual zurück.
GetBitmapEffectInput(Visual)	Gibt den BitmapEffectInput-Wert für das angegebene Visual zurück.
GetCacheMode(Visual)	Ruft die zwischengespeicherte Darstellung des angegebenen Visual-Objekts ab.
GetChild(DependencyObject, Int32)	Gibt das untergeordnete visuelle Objekt vom angegebenen Auflistungsindex in einem angegebenen übergeordneten Element zurück.
GetChildrenCount(DependencyObject)	Gibt die Anzahl von untergeordneten Elementen zurück, die das angegebene visuelle Objekt enthält.
GetClip(Visual)	Gibt den Ausschneidebereich des angegebenen Visual als Geometry-Wert zurück.
GetContentBounds(Visual)	Gibt das zwischengespeicherte umgebende Rechteckfeld für das angegebene Visual zurück.
GetContentBounds(Visual3D)	Gibt das zwischengespeicherte umgebende Rechteckfeld für das angegebene Visual3D zurück.
GetDescendantBounds(Visual)	Gibt die Gesamtmenge aller umgebenden Felder für den Inhalt aller Nachfolgerelemente des Visual, einschließlich des umgebenden Felds für den Inhalt des Visual selbst, zurück.
GetDescendantBounds(Visual3D)	Gibt die Gesamtmenge aller umgebenden Felder für den Inhalt aller Nachfolgerelemente des angegebenen Visual3D, einschließlich des umgebenden Felds für den Inhalt des Visual3D selbst, zurück.
GetDpi(Visual)	Ruft die DPI-Informationen ab, mit denen dieses visuelle Element gemessen und gerendert wird.
GetDrawing(Visual)	Gibt den Zeichnungsinhalt des angegebenen Visual zurück.
GetEdgeMode(Visual)	Gibt den Randmodus des angegebenen Visual als EdgeMode-Wert zurück.
GetEffect(Visual)	Ruft den Bitmapeffekt für das angegebene Visual ab.
GetOffset(Visual)	Gibt den Offset des Visual zurück.
GetOpacity(Visual)	Gibt die Durchlässigkeit des Visual zurück.
GetOpacityMask(Visual)	Gibt einen Brush-Wert zurück, der die Durchlässigkeitsmaske des Visual darstellt.
GetParent(DependencyObject)	Gibt einen DependencyObject-Wert zurück, der das übergeordnete Element des visuellen Objekts darstellt.
GetTransform(Visual)	Gibt einen Transform-Wert für das Visual zurück.
GetXSnappingGuidelines(Visual)	Gibt eine (vertikale) x-Koordinatenführungslinien-Auflistung zurück.
GetYSnappingGuidelines(Visual)	Gibt eine (horizontale) y-Koordinatenführungslinien-Auflistung zurück.
HitTest(Visual, HitTestFilterCallback, HitTestResultCallback, HitTestParameters)	Initiiert einen Treffertest für das angegebene Visual mit den vom Aufrufer definierten Methoden HitTestFilterCallback und HitTestResultCallback.
HitTest(Visual, Point)	Gibt das oberste Visual-Objekt eines Treffertests zurück, indem ein Point angegeben wird.
HitTest(Visual3D, HitTestFilterCallback, HitTestResultCallback, HitTestParameters3D)	Initiiert einen Treffertest für das angegebene Visual3D mit den vom Aufrufer definierten Methoden HitTestFilterCallback und HitTestResultCallback.
SetRootDpi(Visual, DpiScale)	Aktualisiert die DPI-Informationen eines visuellen Elements. Kann nur in einem visuellen Element ohne übergeordnetes Element aufgerufen werden.