VisualCollection.RemoveRange(Int32, Int32) Method

Definition

Namespace:

System.Windows.Media

Assembly:

PresentationCore.dll

Removes a range of visual objects from the VisualCollection.

public:
 void RemoveRange(int index, int count);

public void RemoveRange (int index, int count);

member this.RemoveRange : int * int -> unit

Public Sub RemoveRange (index As Integer, count As Integer)

Parameters

index

Int32

The zero-based index of the range of elements to remove.

count

Int32

The number of elements to remove.

Exceptions

ArgumentOutOfRangeException

index is less than zero or count is less than zero.

ArgumentException

index and count do not refer to a valid range of elements in the VisualCollection.

Remarks

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

The RemoveRange method also removes the parent-child relationships between the parent visual, which is the owner of the VisualCollection, and the range of child visuals.

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.