VisualCollection.Remove(Visual) Methode

Definition

Entfernt das angegebene Visual Objekt aus dem 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
Public Sub Remove (visual As Visual)

Parameter

visual
Visual

The Visual to remove from the VisualCollection.

Hinweise

Die visuellen Objekte, die dem entfernten Objekt folgen, werden verschoben, um die freie Position einzunehmen, und deren Indexwerte werden aktualisiert. Wenn visual ja null, wird der erste null Eintrag entfernt. Beachten Sie, dass das Entfernen eines null Eintrags in der Größe der Auflistung linear ist.

Die Remove Methode entfernt außerdem die Beziehung zwischen dem übergeordneten Element und dem untergeordneten Element zwischen dem übergeordneten Visuellen, dem Besitzer des VisualCollectionElements und dem untergeordneten Element visual.

Wenn Sie eine bessere Kontrolle über die zugrunde liegende Speicherimplementierung von visuellen untergeordneten Objekten benötigen, sollten Sie die Verwendung und AddVisualChildRemoveVisualChild Methoden in Betracht ziehen. Wenn Sie diese Methoden verwenden, definieren Sie Ihre eigene Speicherimplementierung und verwenden VisualCollectionsie nicht.

Gilt für: