VisualTreeHelper Třída

Definice

public ref class VisualTreeHelper abstract sealed

public static class VisualTreeHelper

type VisualTreeHelper = class

Public Class VisualTreeHelper

Dědičnost

Object

VisualTreeHelper

Příklady

Následující příklad ukazuje, jak vytvořit výčet všech potomků vizuálního objektu, což je technika, kterou byste mohli chtít použít, pokud jste chtěli serializovat všechny informace o vykreslování hierarchie vizuálních objektů.

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

Poznámky

Uzly ve vizuálním stromu můžou být buď Visual nebo Visual3D objekty. Metody specifické pro typ vizuálního objektu jsou zadány jako buď Visual nebo Visual3D. Některé metody ve VisualTreeHelper třídě však mohou přijmout DependencyObject hodnotu, která představuje některý typ vizuálního objektu.

WPF podporuje programový přístup k několika různým strukturám stromu objektů. Primárně se zobrazí jako vizuální strom a logický strom. V některých případech je logický strom užitečnější reprezentací prvků v aplikaci WPF, ale koncepční logický strom je implementován na úrovni nad Visual třídou. Na rozdíl od vizuálního stromu může logický strom představovat nevisuální datové objekty, například ListItem. Další informace o logickém stromu najdete v tématu Stromy ve WPF. Logický strom je podporován také podobnou třídou metody nástroje, LogicalTreeHelper.

Metody

Platí pro