다음을 통해 공유


VisualCollection.Add(Visual) 메서드

정의

Visual의 끝에 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

매개 변수

visual
Visual

Visual에 추가할 VisualCollection입니다.

반환

Int32

visual이 추가된 컬렉션의 인덱스입니다.

예외

ArgumentException이 루트 요소이면 Visual이 throw되는 경우

예제

다음 예제에서는 만드는 방법을 보여 줍니다는 VisualCollection 멤버를 추가 합니다.

// 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 샘플을 사용 하 여 테스트 적중합니다.

설명

추가 된 Visual 값인 null 허용 되 고 예외가 발생 하지 않습니다.

Add 메서드는 또한 소유자는 시각적 개체를 부모 간에 부모-자식 관계를 설정의 합니다 VisualCollection, 및 자식 visual합니다.

사용자 지정 클래스의 시각적 자식 개체의 기본 스토리지 구현에 대한 낮은 수준의 제어가 필요한 경우 AddVisualChildRemoveVisualChild 메서드 사용을 고려하세요. 이러한 메서드를 사용할 때는 고유한 스토리지 구현을 정의해야 하며 VisualCollection을 사용하지 않아야 합니다.

적용 대상