Visual.RemoveVisualChild(Visual) Metodo

Definizione

Spazio dei nomi:

System.Windows.Media

Assembly:

PresentationCore.dll

Rimuove la relazione padre-figlio tra due elementi visivi.

protected:
 void RemoveVisualChild(System::Windows::Media::Visual ^ child);

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

member this.RemoveVisualChild : System.Windows.Media.Visual -> unit

Protected Sub RemoveVisualChild (child As Visual)

Parametri

child

Visual

Oggetto visivo figlio da rimuovere dall’elemento visivo padre.

Esempio

Nell'esempio seguente viene illustrato come definire i requisiti di archiviazione personalizzati per un elemento figlio visivo. Nell'esempio vengono usati i AddVisualChild metodi e RemoveVisualChild per configurare la relazione padre-figlio tra l'oggetto visivo padre e child. Per enumerare correttamente l'albero visivo, l'esempio fornisce implementazioni ignorate del metodo e VisualChildrenCount della GetVisualChild proprietà.

Nota

Anche se è possibile usare VisualCollection per creare relazioni padre-figlio tra oggetti visivi, è più efficiente fornire un'implementazione personalizzata dell'archiviazione quando un solo figlio è collegato a un elemento padre.

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

' 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
    Inherits FrameworkElement
    Private _child As DrawingVisual

    Public Sub New(ByVal drawingVisual As DrawingVisual)
        _child = drawingVisual
        Me.AddVisualChild(_child)
    End Sub

    Public Property Child() As DrawingVisual
        Get
            Return _child
        End Get

        Set(ByVal value As DrawingVisual)
            If _child IsNot value Then
                Me.RemoveVisualChild(_child)
                _child = value
                Me.AddVisualChild(_child)
            End If
        End Set
    End Property

    ' Provide a required override for the VisualChildrenCount property.
    Protected Overrides ReadOnly Property VisualChildrenCount() As Integer
        Get
            Return If(_child Is Nothing, 0, 1)
        End Get
    End Property

    ' Provide a required override for the GetVisualChild method.
    Protected Overrides Function GetVisualChild(ByVal index As Integer) As Visual
        If _child Is Nothing Then
            Throw New ArgumentOutOfRangeException()
        End If

        Return _child
    End Function

Commenti

Il RemoveVisualChild metodo rimuove la relazione padre-figlio tra due oggetti visivi. Questo metodo, insieme al AddVisualChild metodo, deve essere usato quando è necessario un maggiore controllo a basso livello sull'implementazione di archiviazione sottostante di oggetti figlio visivi. VisualCollection può essere usato come implementazione predefinita per l'archiviazione di oggetti figlio.

Vedi anche

• VisualCollection