VisualCollection.Insert(Int32, Visual) VisualCollection.Insert(Int32, Visual) VisualCollection.Insert(Int32, Visual) Method

Определение

Вставляет элемент в коллекцию 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

Параметры

index
Int32 Int32 Int32

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

visual
Visual Visual Visual

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

Исключения

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

Комментарии

Если Count значение уже Capacityравно ,емкостьVisual объекта увеличиваетсяVisualCollection до вставки нового.If Count already equals Capacity, the capacity of the VisualCollection is increased before the new Visual is inserted. Если index параметр VisualCollectionравен, тоvisual добавляется в конец. CountIf 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.

Метод также настраивает связь типа «родители-потомки» между родительским визуальным элементом, который является VisualCollectionвладельцем и дочерним visualэлементом. InsertThe 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.

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