FrameworkElement.GetVisualChild(Int32) Метод

Определение

Пространство имен:

System.Windows

Сборка:

PresentationFramework.dll

Переопределяет GetVisualChild(Int32)и возвращает дочерний элемент по указанному индексу из коллекции дочерних элементов.

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

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

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

Protected Overrides Function GetVisualChild (index As Integer) As Visual

Параметры

index

Int32

Отсчитываемый от нуля индекс запрошенного дочернего элемента в коллекции.

Возвращаемое значение

Visual

Запрошенный дочерний элемент. Это не должно возвращать null; если предоставленный индекс выходит за пределы диапазона, создается исключение.

Примеры

В следующем примере показано, как настраиваемое украшение использует значения, объявленные VisualCollection для нескольких дочерних элементов визуального элемента. Эти значения передаются через переопределения VisualChildrenCount и GetVisualChild.

// To store and manage the adorner's visual children.
VisualCollection visualChildren;

' To store and manage the adorner's visual children.
Private visualChildren As VisualCollection

// Override the VisualChildrenCount and GetVisualChild properties to interface with 
// the adorner's visual collection.
protected override int VisualChildrenCount { get { return visualChildren.Count; } }
protected override Visual GetVisualChild(int index) { return visualChildren[index]; }

' Override the VisualChildrenCount and GetVisualChild properties to interface with 
' the adorner's visual collection.
Protected Overrides ReadOnly Property VisualChildrenCount() As Integer
    Get
        Return visualChildren.Count
    End Get
End Property
Protected Overrides Function GetVisualChild(ByVal index As Integer) As Visual
    Return visualChildren(index)
End Function

Комментарии

FrameworkElement В реализации единственный допустимый индекс равен нулю. Модель содержимого поддерживает GetVisualChild либо ноль, либо один дочерний элемент, а не коллекцию.

Примечания для тех, кто наследует этот метод

Эта реализация допустима только для элементов, которые не поддерживают более описательную коллекцию визуальных дочерних элементов. Любой элемент, имеющий такую коллекцию, должен переопределить этот метод и сопоставить индекс с эквивалентным индексом в дочерней коллекции элементов, поддерживаемой этим элементом. Индекс в диапазоне от нуля до VisualChildrenCount (минус один) должен возвращать допустимый элемент. Любой другой индекс должен вызывать исключение из диапазона. Пример типа элемента, который поддерживает дочернюю коллекцию и переопределяет GetVisualChild(Int32) возвращать несколько возможных дочерних Panelэлементов.

Реализация по умолчанию FrameworkElement предполагает только один визуальный дочерний элемент. Любое значение, передаваемое для index другого нуля, приводит к возникновению исключения. Несколько общих элементов, таких как декораторы, декораторы или элементы с специализированной отрисовкой, переопределяют FrameworkElement реализацию (реализации из промежуточных базовых классов). Некоторые реализации по-прежнему применяют один визуальный дочерний элемент, а другие позволяют коллекции.