VisualTreeHelper.GetChild(DependencyObject, Int32) 方法

定义

命名空间:

System.Windows.Media

程序集:

PresentationCore.dll

返回指定父可视对象中位于指定集合索引位置的子可视对象。

public:
 static System::Windows::DependencyObject ^ GetChild(System::Windows::DependencyObject ^ reference, int childIndex);

public static System.Windows.DependencyObject GetChild (System.Windows.DependencyObject reference, int childIndex);

static member GetChild : System.Windows.DependencyObject * int -> System.Windows.DependencyObject

Public Shared Function GetChild (reference As DependencyObject, childIndex As Integer) As DependencyObject

参数

reference

DependencyObject

父可视对象，作为 DependencyObject 引用。

childIndex

Int32

表示 reference 包含的子可视对象的索引。

返回

DependencyObject

子可视对象的索引值。

示例

以下示例演示如何枚举视觉对象的所有后代。 如果你有兴趣序列化视觉对象层次结构的所有呈现信息，或者正在执行分析或替代呈现，则可以使用此方法。

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

注解

GetChildrenCount调用 方法以确定父视觉对象的子元素总数。

的值 reference 可以表示 Visual 或 Visual3D 对象，这就是为什么此处将通用基类型 DependencyObject 用作参数类型的原因。