VisualTreeHelper Klas

Definitie

public ref class VisualTreeHelper abstract sealed

public static class VisualTreeHelper

type VisualTreeHelper = class

Public Class VisualTreeHelper

Overname

Object

VisualTreeHelper

Voorbeelden

In het volgende voorbeeld ziet u hoe u alle afstammelingen van een visueel object opsommen. Dit is een techniek die u mogelijk wilt gebruiken als u geïnteresseerd was in het serialiseren van alle renderinginformatie van een visuele objecthiërarchie.

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

Opmerkingen

Knooppunten in de visualstructuur kunnen objecten of Visual objecten zijnVisual3D. Methoden die specifiek zijn voor een type visueel object, worden getypt als of VisualVisual3D. Sommige methoden in de VisualTreeHelper klasse kunnen echter een DependencyObject waarde accepteren die beide typen visualobjecten vertegenwoordigt.

WPF ondersteunt programmatische toegang tot verschillende structuurstructuren van objecten. Dit wordt voornamelijk weergegeven als een visuele structuur en een logische structuur. In sommige gevallen is de logische structuur een nuttigere weergave van de elementen in een WPF toepassing, maar conceptueel wordt de logische structuur geïmplementeerd op een niveau buiten de klasse Visual. In tegenstelling tot de visualstructuur kan de logische structuur niet-visuele gegevensobjecten voorstellen, zoals ListItem. Zie Trees in WPFvoor meer informatie over de logische structuur. De logische structuur wordt ook ondersteund door een vergelijkbare methodeklasse. LogicalTreeHelper