Visual.GetVisualChild(Int32) 方法

定義

命名空間:

System.Windows.Media

組件:

PresentationCore.dll

傳回父 Visual 中所指定的 VisualCollection。

protected:
 virtual System::Windows::Media::Visual ^ GetVisualChild(int index);

protected virtual System.Windows.Media.Visual GetVisualChild (int index);

abstract member GetVisualChild : int -> System.Windows.Media.Visual
override this.GetVisualChild : int -> System.Windows.Media.Visual

Protected Overridable Function GetVisualChild (index As Integer) As Visual

參數

index

Int32

VisualCollection 中視覺物件的索引。

傳回

Visual

VisualCollection 中指定之 index 值處的子物件。

範例

下列範例會定義 覆寫的 實作 GetVisualChild 。

// Provide a required override for the GetVisualChild method.
protected override Visual GetVisualChild(int index)
{
    if (index < 0 || index >= _children.Count)
    {
        throw new ArgumentOutOfRangeException();
    }

    return _children[index];
}

' Provide a required override for the GetVisualChild method.
Protected Overrides Function GetVisualChild(ByVal index As Integer) As Visual
    If index < 0 OrElse index >= _children.Count Then
        Throw New ArgumentOutOfRangeException()
    End If

    Return _children(index)
End Function

備註

根據預設，沒有 Visual 子系。 因此，預設實作一律會擲回 ArgumentOutOfRangeException 。

給繼承者的注意事項

衍生自 Visual 的類別必須覆寫這個方法，以及 VisualChildrenCount 屬性，才能正確列舉視覺化樹狀結構。