VisualTreeHelper.GetChild(DependencyObject, Int32) メソッド

定義

指定した親内の指定したコレクション インデックス位置から子ビジュアル オブジェクトを返します。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

パラメーター

reference
DependencyObject

DependencyObject として参照される親ビジュアル。The parent visual, referenced as a DependencyObject.

childIndex
Int32

reference に含まれる子ビジュアル表すインデックス。The index that represents the child visual that is contained by reference.

戻り値

子ビジュアル オブジェクトのインデックス値。The index value of the child visual object.

次の例は、ビジュアルオブジェクトのすべての子孫を列挙する方法を示しています。The following example shows how to enumerate all the descendants of a visual object. これは、ビジュアルオブジェクト階層のすべてのレンダリング情報をシリアル化する場合や、分析や別のレンダリングを実行する場合に使用する手法です。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

注釈

親ビジュアルGetChildrenCountの子要素の合計数を確認するには、メソッドを呼び出します。Call the GetChildrenCount method to determine the total number of child elements of a parent visual.

の値はreference 、オブジェクトVisualまたはVisual3Dオブジェクトのいずれかを表すことができますDependencyObject 。ここでは、共通の基本データ型がパラメーター型として使用されています。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.

適用対象