VisualTreeHelper VisualTreeHelper VisualTreeHelper VisualTreeHelper Class

Definition

Stellt Dienstprogrammmethoden für allgemeine Aufgaben bereit, die sich auf Knoten in einer visuellen Struktur auswirken.Provides utility methods that perform common tasks involving nodes in a visual tree.

public ref class VisualTreeHelper abstract sealed
public static class VisualTreeHelper
type VisualTreeHelper = class
Public Class VisualTreeHelper
Vererbung
VisualTreeHelperVisualTreeHelperVisualTreeHelperVisualTreeHelper

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.The following example shows how to enumerate all the descendants of a visual object, which is a technique you might want to use if you were interested in serializing all the rendering information of a visual object hierarchy.

// 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 entweder Visual -oder Visual3D -Objekte sein.Nodes in the visual tree can be either Visual or Visual3D objects. Methoden, die für einen Typ von visuellen Objekten spezifisch sind, werden entweder Visual als Visual3Doder typisiert.Methods that are specific to a type of visual object are typed as either Visual or Visual3D. Einige Methoden in der VisualTreeHelper -Klasse können jedoch einen DependencyObject Wert akzeptieren, der beide Typen von visuellen Objekten darstellt.However, some methods in the VisualTreeHelper class can accept a DependencyObject value that represents either type of visual object.

WPFWPFunterstützt den programmgesteuerten Zugriff auf verschiedene Struktur Strukturen von Objekten.supports programmatic access to several different tree structures of objects. Dies wird in erster Linie als visuelle Struktur und als logische Struktur verfügbar gemacht.Primarily, this is exposed as a visual tree and a logical tree. In einigen Fällen ist die logische Struktur eine nützlichere Darstellung der Elemente in einer WPFWPF -Anwendung, aber konzeptionell wird die logische Struktur auf einer Ebene über der Visual -Klasse implementiert.In some cases, the logical tree is a more useful representation of the elements in a WPFWPF application, but conceptually the logical tree is implemented at a level beyond the Visual class. Anders als ListItembei der visuellen Struktur kann die logische Struktur nicht visuelle Datenobjekte, z. b., darstellen.Unlike the visual tree, the logical tree can represent nonvisual data objects, such as ListItem. Weitere Informationen über die logische Struktur finden Sie unter Strukturen in WPF.For more information on the logical tree, see Trees in WPF. Die logische Struktur wird auch von einer ähnlichen Klasse LogicalTreeHelperder hilfsprogrammmethode unterstützt.The logical tree also is supported by a similar utility method class, LogicalTreeHelper.

Methoden

GetBitmapEffect(Visual) GetBitmapEffect(Visual) GetBitmapEffect(Visual) GetBitmapEffect(Visual)

Gibt den BitmapEffect-Wert für das angegebene Visual zurück.Returns the BitmapEffect value for the specified Visual.

GetBitmapEffectInput(Visual) GetBitmapEffectInput(Visual) GetBitmapEffectInput(Visual) GetBitmapEffectInput(Visual)

Gibt den BitmapEffectInput-Wert für das angegebene Visual zurück.Returns the BitmapEffectInput value for the specified Visual.

GetCacheMode(Visual) GetCacheMode(Visual) GetCacheMode(Visual) GetCacheMode(Visual)

Ruft die zwischengespeicherte Darstellung des angegebenen Visual-Objekts ab.Retrieves the cached representation of the specified Visual.

GetChild(DependencyObject, Int32) GetChild(DependencyObject, Int32) GetChild(DependencyObject, Int32) GetChild(DependencyObject, Int32)

Gibt das untergeordnete visuelle Objekt vom angegebenen Auflistungsindex in einem angegebenen übergeordneten Element zurück.Returns the child visual object from the specified collection index within a specified parent.

GetChildrenCount(DependencyObject) GetChildrenCount(DependencyObject) GetChildrenCount(DependencyObject) GetChildrenCount(DependencyObject)

Gibt die Anzahl von untergeordneten Elementen zurück, die das angegebene visuelle Objekt enthält.Returns the number of children that the specified visual object contains.

GetClip(Visual) GetClip(Visual) GetClip(Visual) GetClip(Visual)

Gibt den Ausschneidebereich des angegebenen Visual als Geometry-Wert zurück.Return the clip region of the specified Visual as a Geometry value.

GetContentBounds(Visual3D) GetContentBounds(Visual3D) GetContentBounds(Visual3D) GetContentBounds(Visual3D)

Gibt das zwischengespeicherte umgebende Rechteckfeld für das angegebene Visual3D zurück.Returns the cached bounding box rectangle for the specified Visual3D.

GetContentBounds(Visual) GetContentBounds(Visual) GetContentBounds(Visual) GetContentBounds(Visual)

Gibt das zwischengespeicherte umgebende Rechteckfeld für das angegebene Visual zurück.Returns the cached bounding box rectangle for the specified Visual.

GetDescendantBounds(Visual3D) GetDescendantBounds(Visual3D) GetDescendantBounds(Visual3D) 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.Returns the union of all the content bounding boxes for all the descendants of the specified Visual3D, which includes the content bounding box of the Visual3D.

GetDescendantBounds(Visual) GetDescendantBounds(Visual) GetDescendantBounds(Visual) 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.Returns the union of all the content bounding boxes for all the descendants of the Visual, which includes the content bounding box of the Visual.

GetDpi(Visual) GetDpi(Visual) GetDpi(Visual) GetDpi(Visual)

Ruft die DPI-Informationen ab, mit denen dieses visuelle Element gemessen und gerendert wird.Gets the DPI information at which this Visual is measured and rendered.

GetDrawing(Visual) GetDrawing(Visual) GetDrawing(Visual) GetDrawing(Visual)

Gibt den Zeichnungsinhalt des angegebenen Visual zurück.Returns the drawing content of the specified Visual.

GetEdgeMode(Visual) GetEdgeMode(Visual) GetEdgeMode(Visual) GetEdgeMode(Visual)

Gibt den Randmodus des angegebenen Visual als EdgeMode-Wert zurück.Returns the edge mode of the specified Visual as an EdgeMode value.

GetEffect(Visual) GetEffect(Visual) GetEffect(Visual) GetEffect(Visual)

Ruft den Bitmapeffekt für das angegebene Visual ab.Gets the bitmap effect for the specified Visual.

GetOffset(Visual) GetOffset(Visual) GetOffset(Visual) GetOffset(Visual)

Gibt den Offset des Visual zurück.Returns the offset of the Visual.

GetOpacity(Visual) GetOpacity(Visual) GetOpacity(Visual) GetOpacity(Visual)

Gibt die Durchlässigkeit des Visual zurück.Returns the opacity of the Visual.

GetOpacityMask(Visual) GetOpacityMask(Visual) GetOpacityMask(Visual) GetOpacityMask(Visual)

Gibt einen Brush-Wert zurück, der die Durchlässigkeitsmaske des Visual darstellt.Returns a Brush value that represents the opacity mask of the Visual.

GetParent(DependencyObject) GetParent(DependencyObject) GetParent(DependencyObject) GetParent(DependencyObject)

Gibt einen DependencyObject-Wert zurück, der das übergeordnete Element des visuellen Objekts darstellt.Returns a DependencyObject value that represents the parent of the visual object.

GetTransform(Visual) GetTransform(Visual) GetTransform(Visual) GetTransform(Visual)

Gibt einen Transform-Wert für das Visual zurück.Returns a Transform value for the Visual.

GetXSnappingGuidelines(Visual) GetXSnappingGuidelines(Visual) GetXSnappingGuidelines(Visual) GetXSnappingGuidelines(Visual)

Gibt eine Auflistung der Führungslinien für die x-Koordinate (vertikal) zurück.Returns an X-coordinate (vertical) guideline collection.

GetYSnappingGuidelines(Visual) GetYSnappingGuidelines(Visual) GetYSnappingGuidelines(Visual) GetYSnappingGuidelines(Visual)

Gibt eine Auflistung der Führungslinien für die y-Koordinate (horizontal) zurück.Returns a Y-coordinate (horizontal) guideline collection.

HitTest(Visual, Point) HitTest(Visual, Point) HitTest(Visual, Point) HitTest(Visual, Point)

Gibt das oberste Visual-Objekt eines Treffertests zurück, indem ein Point angegeben wird.Returns the topmost Visual object of a hit test by specifying a Point.

HitTest(Visual3D, HitTestFilterCallback, HitTestResultCallback, HitTestParameters3D) HitTest(Visual3D, HitTestFilterCallback, HitTestResultCallback, HitTestParameters3D) HitTest(Visual3D, HitTestFilterCallback, HitTestResultCallback, HitTestParameters3D) HitTest(Visual3D, HitTestFilterCallback, HitTestResultCallback, HitTestParameters3D)

Initiiert einen Treffertest für das angegebene Visual3D mit den vom Aufrufer definierten Methoden HitTestFilterCallback und HitTestResultCallback.Initiates a hit test on the specified Visual3D, with caller-defined HitTestFilterCallback and HitTestResultCallback methods.

HitTest(Visual, HitTestFilterCallback, HitTestResultCallback, HitTestParameters) HitTest(Visual, HitTestFilterCallback, HitTestResultCallback, HitTestParameters) HitTest(Visual, HitTestFilterCallback, HitTestResultCallback, HitTestParameters) HitTest(Visual, HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Initiiert einen Treffertest für das angegebene Visual mit den vom Aufrufer definierten Methoden HitTestFilterCallback und HitTestResultCallback.Initiates a hit test on the specified Visual, with caller-defined HitTestFilterCallback and HitTestResultCallback methods.

SetRootDpi(Visual, DpiScale) SetRootDpi(Visual, DpiScale) SetRootDpi(Visual, DpiScale) SetRootDpi(Visual, DpiScale)

Aktualisiert die DPI-Informationen eines visuellen Elements.Updates the DPI information of a Visual. Kann nur in einem visuellen Element ohne übergeordnetes Element aufgerufen werden.It can only be called on a Visual without a parent.

Gilt für: