VisualTreeHelper.GetChildrenCount(DependencyObject) Method

Definition

Devuelve el número de elementos secundarios que el objeto visual especificado contiene.Returns the number of children that the specified visual object contains.

public:
 static int GetChildrenCount(System::Windows::DependencyObject ^ reference);
public static int GetChildrenCount (System.Windows.DependencyObject reference);
static member GetChildrenCount : System.Windows.DependencyObject -> int
Public Shared Function GetChildrenCount (reference As DependencyObject) As Integer

Parameters

reference
DependencyObject

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

Returns

Int32

Número de objetos visuales secundarios que el objeto visual primario contiene.The number of child visuals that the parent visual contains.

Examples

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

Remarks

Use el método GetChild para recuperar un elemento secundario especificado de un objeto visual primario.Use the GetChild method to retrieve a specified child of a parent visual.

El valor de reference puede representar un objeto Visual o Visual3D, que es el motivo por el que se usa el tipo base común DependencyObject 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.

Applies to