UIElement.OnRender(DrawingContext) Metode

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationCore.dll

Ketika ditimpa di kelas turunan, berpartisipasi dalam operasi penyajian yang diarahkan oleh sistem tata letak. Instruksi penyajian untuk elemen ini tidak digunakan secara langsung ketika metode ini dipanggil, dan sebaliknya dipertahankan untuk penggunaan asinkron nanti dengan tata letak dan gambar.

protected:
 virtual void OnRender(System::Windows::Media::DrawingContext ^ drawingContext);

protected virtual void OnRender (System.Windows.Media.DrawingContext drawingContext);

abstract member OnRender : System.Windows.Media.DrawingContext -> unit
override this.OnRender : System.Windows.Media.DrawingContext -> unit

Protected Overridable Sub OnRender (drawingContext As DrawingContext)

Parameter

drawingContext

DrawingContext

Instruksi menggambar untuk elemen tertentu. Konteks ini disediakan untuk sistem tata letak.

Contoh

Contoh kode berikut menunjukkan kemungkinan implementasi untuk kelas turunan panel.

// Override the OnRender call to add a Background and Border to the OffSetPanel
protected override void OnRender(DrawingContext dc)
{
    SolidColorBrush mySolidColorBrush  = new SolidColorBrush();
    mySolidColorBrush.Color = Colors.LimeGreen;
    Pen myPen = new Pen(Brushes.Blue, 10);
    Rect myRect = new Rect(0, 0, 500, 500);
    dc.DrawRectangle(mySolidColorBrush, myPen, myRect);
}

' Override the OnRender call to add a Background and Border to the OffSetPanel
Protected Overrides Sub OnRender(ByVal dc As DrawingContext)
    Dim mySolidColorBrush As New SolidColorBrush()
    mySolidColorBrush.Color = Colors.LimeGreen
    Dim myPen As New Pen(Brushes.Blue, 10)
    Dim myRect As New Rect(0, 0, 500, 500)
    dc.DrawRectangle(mySolidColorBrush, myPen, myRect)
End Sub

Keterangan

Metode ini tidak memiliki implementasi default di UIElement kelas .

Catatan Bagi Inheritor

Metode OnRender(DrawingContext) ini dapat ditimpa untuk menambahkan elemen grafis lebih lanjut (tidak sebelumnya didefinisikan dalam pohon logis) ke elemen yang dirender, seperti efek atau pelari. Objek DrawingContext diteruskan sebagai argumen, yang menyediakan metode untuk menggambar bentuk, teks, gambar, atau video.