This documentation is archived and is not being maintained.

VisualCollection.Remove Method

Removes the specified Visual object from the VisualCollection.

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

public void Remove (
	Visual visual
)
public void Remove (
	Visual visual
)
public function Remove (
	visual : Visual
)
You cannot use methods in XAML.

Parameters

visual

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. If visual is a null reference (Nothing in Visual Basic), the first a null reference (Nothing in Visual Basic) entry is removed. Note that removing a a null reference (Nothing in Visual Basic) entry is linear in the size of the collection.

The Remove 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.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0
Show: