VisualCollection.RemoveAt(Int32) Method

Reference

Definition

Namespace:: System.Windows.Media

Assembly:: PresentationCore.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Removes the visual object at the specified index in the VisualCollection.

public:
 void RemoveAt(int index);

public void RemoveAt (int index);

member this.RemoveAt : int -> unit

Public Sub RemoveAt (index As Integer)

Parameters

index: Int32

The zero-based index of the visual to remove.

Exceptions

ArgumentOutOfRangeException

index is less than zero, or index is equal to or greater than Count.

Remarks

The visual objects that follow the removed object are shifted to occupy the vacated position, and their index values are updated.

The RemoveAt method also removes the parent-child relationship between the parent visual, which is the owner of the VisualCollection, and the child visual.

If you need greater low-level control over the underlying storage implementation of visual child objects, consider using the AddVisualChild and RemoveVisualChild methods. When you use these methods, you define your own storage implementation, and do not use VisualCollection.

Applies to