VisualCollection.RemoveAt Method

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

Namespace:  System.Windows.Media
Assembly:  PresentationCore (in PresentationCore.dll)

public void RemoveAt(
	int index
)

Parameters

index
Type: System.Int32
The zero-based index of the visual to remove.

ExceptionCondition
ArgumentOutOfRangeException

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

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.

.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft