VisualTreeHelper.GetChild(DependencyObject, Int32) VisualTreeHelper.GetChild(DependencyObject, Int32) VisualTreeHelper.GetChild(DependencyObject, Int32) VisualTreeHelper.GetChild(DependencyObject, Int32) Method

Definición

Devuelve el objeto visual secundario del índice de colección especificado dentro de un elemento primario especificado.Returns the child visual object from the specified collection index within a specified parent.

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

Parámetros

reference
DependencyObject DependencyObject DependencyObject DependencyObject

Objeto visual primario, al que se hace referencia como DependencyObject.The parent visual, referenced as a DependencyObject.

childIndex
Int32 Int32 Int32 Int32

Índice que representa el objeto visual secundario que contiene reference.The index that represents the child visual that is contained by reference.

Devoluciones

Valor de índice del objeto visual secundario.The index value of the child visual object.

Ejemplos

En el ejemplo siguiente se muestra cómo enumerar todos los descendientes de un objeto visual.The following example shows how to enumerate all the descendants of a visual object. Se trata de una técnica que puede usar si está interesado en serializar toda la información de representación de una jerarquía de objetos visuales o para realizar análisis o representaciones alternativas.This is a technique you might use if you are interested in serializing all the rendering information of a visual object hierarchy or are performing analysis or alternative rendering.

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

Comentarios

Llame al GetChildrenCount método para determinar el número total de elementos secundarios de un objeto visual primario.Call the GetChildrenCount method to determine the total number of child elements of a parent visual.

El valor de reference puede representar un Visual objeto o Visual3D , que es el motivo por el que se DependencyObject usa el tipo base común aquí como un tipo de parámetro.The value of reference can represent either a Visual or Visual3D object, which is why the common base type DependencyObject is used here as a parameter type.

Se aplica a