VisualCollection.Add(Visual) Yöntem

Tanım

sonuna bir VisualVisualCollectionekler.

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

Parametreler

visual
Visual

Visual sonuna eklenecek öğesini seçinVisualCollection.

Döndürülenler

Eklendiği visual koleksiyondaki dizin.

Özel durumlar

bir ArgumentException kök öğesiyse Visual oluşturulur.

Örnekler

Aşağıdaki örnekte, nasıl VisualCollection oluşturulacağı ve buna üye ekleneceği gösterilmektedir.

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

Not

Örneğin tamamı için bkz. Çizim Kullanarak İsabet TestiVisuals Örneği.

Açıklamalar

Değerine null izin verilen ve özel durum oluşturmayan bir Visual ekleme.

yöntemi, Add üst görsel arasındaki üst-alt ilişkisini de ayarlar. Bu, öğesinin VisualCollectionsahibi ve alt visualöğesidir.

Özel bir sınıfın görsel alt nesnelerinin temel depolama uygulaması üzerinde daha düşük düzeyde denetime ihtiyacınız varsa ve RemoveVisualChild yöntemlerini kullanmayı AddVisualChild göz önünde bulundurun. Bu yöntemleri kullandığınızda, kendi depolama uygulamanızı tanımlamanız gerekir ve kullanmamalısınız VisualCollection.

Şunlara uygulanır