Menggunakan Objek DrawingVisual

Artikel
10/18/2023

Topik ini memberikan gambaran umum tentang cara menggunakan DrawingVisual objek di lapisan visual WPF.

Objek DrawingVisual

adalah DrawingVisual kelas gambar ringan yang digunakan untuk merender bentuk, gambar, atau teks. Kelas ini dianggap ringan karena tidak menyediakan tata letak atau penanganan peristiwa, yang meningkatkan performanya. Untuk alasan ini, gambar sangat ideal untuk latar belakang dan clip art.

DrawingVisual Host Container

Untuk menggunakan DrawingVisual objek, Anda perlu membuat kontainer host untuk objek. Objek kontainer host harus berasal dari FrameworkElement kelas , yang menyediakan tata letak dan dukungan penanganan peristiwa yang DrawingVisual tidak memiliki kelas. Objek kontainer host tidak menampilkan properti yang terlihat, karena tujuan utamanya adalah untuk berisi objek anak. Namun, Visibility properti kontainer host harus diatur ke Visible; jika tidak, tidak ada elemen turunannya yang akan terlihat.

Saat Anda membuat objek kontainer host untuk objek visual, Anda perlu menyimpan referensi objek visual dalam VisualCollection. Add Gunakan metode untuk menambahkan objek visual ke kontainer host. Dalam contoh berikut, objek kontainer host dibuat, dan tiga objek visual ditambahkan ke 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

Catatan

Untuk sampel kode lengkap tempat contoh kode sebelumnya diekstrak, lihat Uji Tekan Menggunakan Sampel DrawingVisuals.

Membuat Objek DrawingVisual

Saat Anda membuat DrawingVisual objek, objek tidak memiliki konten gambar. Anda dapat menambahkan teks, grafik, atau konten gambar dengan mengambil objek DrawingContext dan menggambar ke dalamnya. DrawingContext dikembalikan dengan memanggil RenderOpen metode DrawingVisual objek.

Untuk menggambar persegi ke dalam DrawingContext, gunakan DrawRectangle metode DrawingContext objek. Metode serupa ada untuk menggambar jenis konten lainnya. Ketika Anda selesai menggambar konten ke dalam DrawingContext, panggil Close metode untuk menutup DrawingContext dan mempertahankan konten.

Dalam contoh berikut, DrawingVisual objek dibuat, dan persegi digambar ke dalam .DrawingContext

// Create a DrawingVisual that contains a rectangle.
private DrawingVisual CreateDrawingVisualRectangle()
{
    DrawingVisual drawingVisual = new DrawingVisual();

    // Retrieve the DrawingContext in order to create new drawing content.
    DrawingContext drawingContext = drawingVisual.RenderOpen();

    // Create a rectangle and draw it in the DrawingContext.
    Rect rect = new Rect(new System.Windows.Point(160, 100), new System.Windows.Size(320, 80));
    drawingContext.DrawRectangle(System.Windows.Media.Brushes.LightBlue, (System.Windows.Media.Pen)null, rect);

    // Persist the drawing content.
    drawingContext.Close();

    return drawingVisual;
}

' Create a DrawingVisual that contains a rectangle.
Private Function CreateDrawingVisualRectangle() As DrawingVisual
    Dim drawingVisual As New DrawingVisual()

    ' Retrieve the DrawingContext in order to create new drawing content.
    Dim drawingContext As DrawingContext = drawingVisual.RenderOpen()

    ' Create a rectangle and draw it in the DrawingContext.
    Dim rect As New Rect(New Point(160, 100), New Size(320, 80))
    drawingContext.DrawRectangle(Brushes.LightBlue, CType(Nothing, Pen), rect)

    ' Persist the drawing content.
    drawingContext.Close()

    Return drawingVisual
End Function

Membuat Penimpaan untuk Anggota FrameworkElement

Objek kontainer host bertanggung jawab untuk mengelola kumpulan objek visualnya. Ini mengharuskan anggota implement kontainer host mengambil alih untuk kelas turunan FrameworkElement .

Daftar berikut ini menjelaskan dua anggota yang harus Anda ambil alih:

GetVisualChild: Mengembalikan anak pada indeks yang ditentukan dari kumpulan elemen turunan.
VisualChildrenCount: Mendapatkan jumlah elemen anak visual dalam elemen ini.

Dalam contoh berikut, penimpaan untuk kedua FrameworkElement anggota diimplementasikan.


// Provide a required override for the VisualChildrenCount property.
protected override int VisualChildrenCount
{
    get { return _children.Count; }
}

// Provide a required override for the GetVisualChild method.
protected override Visual GetVisualChild(int index)
{
    if (index < 0 || index >= _children.Count)
    {
        throw new ArgumentOutOfRangeException();
    }

    return _children[index];
}


' Provide a required override for the VisualChildrenCount property.
Protected Overrides ReadOnly Property VisualChildrenCount() As Integer
    Get
        Return _children.Count
    End Get
End Property

' Provide a required override for the GetVisualChild method.
Protected Overrides Function GetVisualChild(ByVal index As Integer) As Visual
    If index < 0 OrElse index >= _children.Count Then
        Throw New ArgumentOutOfRangeException()
    End If

    Return _children(index)
End Function

Memberikan Dukungan Pengujian Hit

Objek kontainer host dapat menyediakan penanganan peristiwa meskipun tidak menampilkan properti yang terlihat—namun, propertinya Visibility harus diatur ke Visible. Ini memungkinkan Anda membuat rutinitas penanganan peristiwa untuk kontainer host yang dapat menjebak peristiwa mouse, seperti pelepasan tombol mouse kiri. Rutinitas penanganan peristiwa kemudian dapat menerapkan pengujian hit dengan memanggil HitTest metode . Parameter metode HitTestResultCallback mengacu pada prosedur yang ditentukan pengguna yang dapat Anda gunakan untuk menentukan tindakan yang dihasilkan dari pengujian hit.

Dalam contoh berikut, dukungan pengujian hit diimplementasikan untuk objek kontainer host dan anak-anaknya.

// Capture the mouse event and hit test the coordinate point value against
// the child visual objects.
void MyVisualHost_MouseLeftButtonUp(object sender, System.Windows.Input.MouseButtonEventArgs e)
{
    // Retrieve the coordinates of the mouse button event.
    System.Windows.Point pt = e.GetPosition((UIElement)sender);

    // Initiate the hit test by setting up a hit test result callback method.
    VisualTreeHelper.HitTest(this, null, new HitTestResultCallback(myCallback), new PointHitTestParameters(pt));
}

// If a child visual object is hit, toggle its opacity to visually indicate a hit.
public HitTestResultBehavior myCallback(HitTestResult result)
{
    if (result.VisualHit.GetType() == typeof(DrawingVisual))
    {
        if (((DrawingVisual)result.VisualHit).Opacity == 1.0)
        {
            ((DrawingVisual)result.VisualHit).Opacity = 0.4;
        }
        else
        {
            ((DrawingVisual)result.VisualHit).Opacity = 1.0;
        }
    }

    // Stop the hit test enumeration of objects in the visual tree.
    return HitTestResultBehavior.Stop;
}

' Capture the mouse event and hit test the coordinate point value against
' the child visual objects.
Private Sub MyVisualHost_MouseLeftButtonUp(ByVal sender As Object, ByVal e As MouseButtonEventArgs)
    ' Retrieve the coordinates of the mouse button event.
    Dim pt As Point = e.GetPosition(CType(sender, UIElement))

    ' Initiate the hit test by setting up a hit test result callback method.
    VisualTreeHelper.HitTest(Me, Nothing, New HitTestResultCallback(AddressOf myCallback), New PointHitTestParameters(pt))
End Sub

' If a child visual object is hit, toggle its opacity to visually indicate a hit.
Public Function myCallback(ByVal result As HitTestResult) As HitTestResultBehavior
    If result.VisualHit.GetType() Is GetType(DrawingVisual) Then
        If (CType(result.VisualHit, DrawingVisual)).Opacity = 1.0 Then
            CType(result.VisualHit, DrawingVisual).Opacity = 0.4
        Else
            CType(result.VisualHit, DrawingVisual).Opacity = 1.0
        End If
    End If

    ' Stop the hit test enumeration of objects in the visual tree.
    Return HitTestResultBehavior.Stop
End Function

Bagikan melalui

Menggunakan Objek DrawingVisual

Objek DrawingVisual

DrawingVisual Host Container

Membuat Objek DrawingVisual

Membuat Penimpaan untuk Anggota FrameworkElement

Memberikan Dukungan Pengujian Hit

Baca juga

Saran dan Komentar

Sumber Daya Tambahan: