Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Visual.RemoveVisualChild-Methode (Visual)

 

Entfernt die hierarchische Beziehung zwischen zwei visuellen Elementen.

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

protected void RemoveVisualChild(
	Visual child
)

Parameter

child

Das untergeordnete visuelle Objekt, das vom übergeordneten visuellen Element entfernt werden soll.

Die RemoveVisualChild-Methode entfernt die hierarchische Beziehung zwischen zwei visuellen Elementen.Diese Methode muss zusammen mit der AddVisualChild-Methode verwendet werden, wenn Sie eine umfassendere Steuerung auf niedriger Ebene der zugrunde liegenden Speicherimplementierung für untergeordnete visuelle Objekte benötigen. VisualCollection kann als Standardimplementierung zum Speichern von untergeordneten Objekten verwendet werden.

Im folgenden Beispiel wird gezeigt, wie benutzerdefinierte Speicheranforderungen für ein visuelles untergeordnetes Element definiert werden.In dem Beispiel werden die AddVisualChild-Methode und die RemoveVisualChild-Methode verwendet, um die hierarchische Beziehung zwischen dem übergeordneten visuellen Element child einzurichten.Damit die visuelle Struktur ordnungsgemäß aufgelistet wird, werden im Beispiel überschriebene Implementierungen der GetVisualChild-Methode und der VisualChildrenCount-Eigenschaft bereitgestellt.

System_CAPS_noteHinweis

Zwar kann VisualCollection zum Erstellen hierarchischer Beziehungen zwischen visuellen Elementen verwendet werden, doch ist es effizienter, eine eigene benutzerdefinierte Speicherimplemenierung bereitzustellen, wenn nur ein einzelnes untergeordnetes Element mit einem übergeordneten Element verknüpft ist.

// Create a host visual derived from the FrameworkElement class.
// This class provides layout, event handling, and container support for
// the child visual object.
public class MyVisualHost : FrameworkElement
{
    private DrawingVisual _child;

    public MyVisualHost(DrawingVisual drawingVisual)
    {
        _child = drawingVisual;
        this.AddVisualChild(_child);
    }

    public DrawingVisual Child
    {
        get
        {
            return _child;
        }

        set
        {
            if (_child != value)
            {
                this.RemoveVisualChild(_child);
                _child = value;
                this.AddVisualChild(_child);
            }
        }
    }

    // Provide a required override for the VisualChildrenCount property.
    protected override int VisualChildrenCount
    {
        get { return _child == null ? 0 : 1; }
    }

    // Provide a required override for the GetVisualChild method.
    protected override Visual GetVisualChild(int index)
    {
        if (_child == null)
        {
            throw new ArgumentOutOfRangeException();
        }

        return _child;
    }

.NET Framework
Verfügbar seit 3.0
Zurück zum Anfang
Anzeigen: