Visual.RemoveVisualChild(Visual) Metoda

Definice

Obor názvů:

System.Windows.Media

Sestavení:

PresentationCore.dll

Odebere vztah nadřazenosti a podřízenosti mezi dvěma vizuály.

C#

protected void RemoveVisualChild(System.Windows.Media.Visual child);

Parametry

child

Visual

Podřízený objekt vizuálu, který se má odebrat z nadřazeného vizuálu.

Příklady

Následující příklad ukazuje, jak definovat vlastní požadavky na úložiště pro podřízené vizuály. Příklad používá AddVisualChild metody a RemoveVisualChild k nastavení vztahu nadřazenosti a podřízenosti mezi nadřazeným vizuálem a child. Aby byl vizuální strom správně vyčíslený, příklad poskytuje přepsání GetVisualChild implementace metody a VisualChildrenCount vlastnosti.

Poznámka

I když je možné vytvořit VisualCollection vztahy nadřazenosti a podřízenosti mezi vizuálními objekty, je efektivnější poskytnout vlastní implementaci úložiště, pokud je s nadřazeným objektem propojen pouze jeden podřízený objekt.

C#

// 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;
    }

Poznámky

Metoda RemoveVisualChild odebere vztah nadřazenosti a podřízenosti mezi dvěma vizuály. Tuto metodu spolu s metodou AddVisualChild je nutné použít, pokud potřebujete větší kontrolu nad základní implementací úložiště podřízených objektů vizuálu. VisualCollection lze použít jako výchozí implementaci pro ukládání podřízených objektů.

Platí pro

Viz také

• VisualCollection