VisualCollection.Remove(Visual) VisualCollection.Remove(Visual) VisualCollection.Remove(Visual) Method

Определение

Удаляет указанный объект Visual из объекта VisualCollection.Removes the specified Visual object from the VisualCollection.

public:
 void Remove(System::Windows::Media::Visual ^ visual);
public void Remove (System.Windows.Media.Visual visual);
member this.Remove : System.Windows.Media.Visual -> unit

Параметры

visual
Visual Visual Visual

Элемент Visual, который требуется удалить из VisualCollection.The Visual to remove from the VisualCollection.

Комментарии

Визуальные объекты, следующие за удаленным объектом, сдвигаются, чтобы занимать освободившееся позицию, и значения их индексов обновляются.The visual objects that follow the removed object are shifted to occupy the vacated position, and their index values are updated. Если visual имеет nullзначение, первая null запись удаляется.If visual is null, the first null entry is removed. Обратите внимание, null что удаление записи является линейной в размере коллекции.Note that removing a null entry is linear in the size of the collection.

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

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