Поделиться через

VisualCollection.Insert(Int32, Visual) Метод

  • Ссылка

Определение

Пространство имен:
System.Windows.Media
Сборка:
PresentationCore.dll

Вставляет элемент в коллекцию VisualCollection по указанному индексу.

public:
 void Insert(int index, System::Windows::Media::Visual ^ visual);
public void Insert (int index, System.Windows.Media.Visual visual);
member this.Insert : int * System.Windows.Media.Visual -> unit
Public Sub Insert (index As Integer, visual As Visual)

Параметры

index
Int32

Индекс (с нуля), по которому следует вставить значение.

visual
Visual

Объект Visual, вставляемый в VisualCollection.

Исключения

ArgumentOutOfRangeException

index меньше нуля или больше Count.

Комментарии

Если Count значение уже равно Capacity, емкость VisualCollection увеличивается до вставки нового Visual . Если index равно Count, visual добавляется в конец VisualCollection. Все существующие визуальные объекты, равные или больше index , смещаются в соответствии с новыми Visualзначениями индекса и обновляются.

Метод Insert также настраивает связь "родитель-потомок" между родительским визуальным элементом, который является владельцем дочернего VisualCollectionэлемента и дочерним visualэлементом.

Если вам нужен более низкий контроль над базовой реализацией хранилища визуальных дочерних объектов, рассмотрите возможность использования AddVisualChild методов и RemoveVisualChild методов. При использовании этих методов вы определяете собственную реализацию хранилища и не используете VisualCollection.

Применяется к