VisualCollection.Add(Visual) Metode

Definisi

Ruang nama:

System.Windows.Media

Rakitan:

PresentationCore.dll

Visual Menambahkan ke akhir VisualCollection.

public:
 int Add(System::Windows::Media::Visual ^ visual);

public int Add(System.Windows.Media.Visual visual);

member this.Add : System.Windows.Media.Visual -> int

Public Function Add (visual As Visual) As Integer

Parameter

visual

Visual

untuk Visual menambahkan ke VisualCollection.

Mengembalikan

Int32

Indeks dalam koleksi tempat visual ditambahkan.

Pengecualian

ArgumentException

Dilemparkan ArgumentExceptionVisual jika adalah elemen akar.

Contoh

Contoh berikut menunjukkan cara membuat VisualCollection dan menambahkan anggota ke dalamnya.

// Create a host visual derived from the FrameworkElement class.
// This class provides layout, event handling, and container support for
// the child visual objects.
public class MyVisualHost : FrameworkElement
{
    // Create a collection of child visual objects.
    private VisualCollection _children;

    public MyVisualHost()
    {
        _children = new VisualCollection(this);
        _children.Add(CreateDrawingVisualRectangle());
        _children.Add(CreateDrawingVisualText());
        _children.Add(CreateDrawingVisualEllipses());

        // Add the event handler for MouseLeftButtonUp.
        this.MouseLeftButtonUp += new System.Windows.Input.MouseButtonEventHandler(MyVisualHost_MouseLeftButtonUp);
    }

' Create a host visual derived from the FrameworkElement class.
' This class provides layout, event handling, and container support for
' the child visual objects.
Public Class MyVisualHost
    Inherits FrameworkElement
    ' Create a collection of child visual objects.
    Private _children As VisualCollection

    Public Sub New()
        _children = New VisualCollection(Me)
        _children.Add(CreateDrawingVisualRectangle())
        _children.Add(CreateDrawingVisualText())
        _children.Add(CreateDrawingVisualEllipses())

        ' Add the event handler for MouseLeftButtonUp.
        AddHandler MouseLeftButtonUp, AddressOf MyVisualHost_MouseLeftButtonUp
    End Sub

Note

Untuk sampel lengkapnya, lihat Uji Menggunakan Sampel DrawingVisuals.

Keterangan

Menambahkan nilai Visual yang nilainya null diizinkan dan tidak menimbulkan pengecualian.

Metode ini Add juga menyiapkan hubungan induk-anak antara visual induk, yang merupakan pemilik VisualCollection, dan anak visual.

Jika Anda memerlukan kontrol tingkat rendah yang lebih besar atas implementasi penyimpanan yang mendasar dari objek anak visual dari kelas kustom, pertimbangkan untuk menggunakan AddVisualChild metode dan RemoveVisualChild . Ketika Anda menggunakan metode ini, Anda harus menentukan implementasi penyimpanan Anda sendiri, dan tidak menggunakan VisualCollection.