VisualCollection.Insert(Int32, Visual) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Вставляет элемент в коллекцию 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 -> unitPublic Sub Insert (index As Integer, visual As Visual)Параметры
- index
- Int32
Индекс (с нуля), по которому следует вставить значение.
- visual
- Visual
Объект Visual, вставляемый в VisualCollection.
Исключения
index меньше нуля или больше Count.
Комментарии
Если Count значение уже равно Capacity, емкость VisualCollection увеличивается до вставки нового Visual . Если index равно Count, visual добавляется в конец VisualCollection. Все существующие визуальные объекты, равные или больше index , смещаются в соответствии с новыми Visualзначениями индекса и обновляются.
Метод Insert также настраивает связь "родитель-потомок" между родительским визуальным элементом, который является владельцем дочернего VisualCollectionэлемента и дочерним visualэлементом.
Если вам нужен более низкий контроль над базовой реализацией хранилища визуальных дочерних объектов, рассмотрите возможность использования AddVisualChild методов и RemoveVisualChild методов. При использовании этих методов вы определяете собственную реализацию хранилища и не используете VisualCollection.