VisualCollection.Add(Visual) VisualCollection.Add(Visual) VisualCollection.Add(Visual) Method

Определение

Добавляет объект Visual в конец VisualCollection.Appends a Visual to the end of the 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

Параметры

visual
Visual Visual Visual

Объект Visual, добавляемый в коллекцию VisualCollection.The Visual to append to the VisualCollection.

Возвраты

Индекс в коллекции, по которому был добавлен параметр visual.The index in the collection at which visual was added.

Исключения

Исключение ArgumentException выбрасывается, если Visual является корневым элементом.An ArgumentException is thrown if the Visual is a root element.

Примеры

В следующем примере показано, как создать VisualCollection и добавить в него элементы.The following example shows how to create a VisualCollection and add members to it.

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

Примечание

Полный пример см. в разделе Проверка попадания с помощью примера DrawingVisuals.For the complete sample, see Hit Test Using DrawingVisuals Sample.

Комментарии

Добавление, Visual null значение которого разрешено и не вызывает исключение.Adding a Visual whose value is null is permitted and does not raise an exception.

Метод также настраивает связь типа «родители-потомки» между родительским визуальным элементом, который является VisualCollectionвладельцем и дочерним visualэлементом. AddThe Add method also sets up the parent-child relationship between the parent visual, which is the owner of the VisualCollection, and the child visual.

Если требуется более низкий уровень контроля над реализацией базового хранилища визуальных дочерних объектов пользовательского класса, рассмотрите возможность использования AddVisualChild методов и. RemoveVisualChildIf you need greater low-level control over the underlying storage implementation of visual child objects of a custom class, consider using the AddVisualChild and RemoveVisualChild methods. При использовании этих методов необходимо определить собственную реализацию хранилища и не использовать VisualCollection.When you use these methods, you must define your own storage implementation, and do not use VisualCollection.

Применяется к