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

Определение

Вставляет элемент в коллекцию VisualCollection по указанному индексу.Inserts an element into the VisualCollection at the specified index.

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

Индекс (с нуля), по которому следует вставить значение.The zero-based index at which the value should be inserted.

visual
Visual

Объект Visual, вставляемый в VisualCollection.The Visual to insert into the VisualCollection.

Исключения

index меньше нуля или больше Count.index is less than zero or greater than Count.

Комментарии

Если значение Count уже равно Capacity , емкость объекта VisualCollection увеличивается до вставки нового Visual .If Count already equals Capacity, the capacity of the VisualCollection is increased before the new Visual is inserted. Если index параметр равен Count , visual то добавляется в конец VisualCollection .If index is equal to Count, visual is added to the end of VisualCollection. Все существующие визуальные объекты, которые равны или больше, index сдвигаются в соответствии с новым Visual , а значения их индексов обновляются.Any existing visual objects that are equal to or greater than index are shifted to accommodate the new Visual, and their index values are updated.

InsertМетод также настраивает связь типа «родители-потомки» между родительским визуальным элементом, который является владельцем VisualCollection и дочерним элементом visual .The Insert method also sets up the parent-child relationship between the parent visual, which is the owner of the VisualCollection, and the child visual.

Если вам требуется более низкий уровень контроля над реализацией базового хранилища визуальных дочерних объектов, рассмотрите возможность использования AddVisualChild RemoveVisualChild методов и.If you need greater low-level control over the underlying storage implementation of visual child objects, consider using the AddVisualChild and RemoveVisualChild methods. При использовании этих методов вы определяете собственную реализацию хранилища и не используете VisualCollection .When you use these methods, you define your own storage implementation, and do not use VisualCollection.

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