(0) exportieren Drucken
Alle erweitern
Erweitern Minimieren

UIElement.OnRender-Methode

Aktualisiert: November 2007

Nimmt beim Überschreiben in einer abgeleiteten Klasse an Renderingvorgängen teil, die durch das Layoutsystem gesteuert werden. Die Renderinganweisungen für dieses Element werden beim Aufrufen dieser Methode nicht direkt verwendet, sondern stattdessen für spätere asynchrone Layout- und Zeichnungsvorgänge beibehalten.

Namespace:  System.Windows
Assembly:  PresentationCore (in PresentationCore.dll)

protected virtual void OnRender(
	DrawingContext drawingContext
)
protected void OnRender(
	DrawingContext drawingContext
)
protected function OnRender(
	drawingContext : DrawingContext
)
Sie können diese Methoden nicht in XAML verwenden.

Parameter

drawingContext
Typ: System.Windows.Media.DrawingContext
Die Zeichnungsanweisungen für ein bestimmtes Element. Dieser Kontext wird für das Layoutsystem bereitgestellt.

Diese Methode weist keine Standardimplementierung in der UIElement-Klasse auf.

Hinweise zur Vererbung:

Die OnRender-Methode kann überschrieben werden, um einem gerenderten Element weitere (bisher in einer logischen Struktur nicht definierte) grafische Elemente hinzuzufügen, beispielsweise Effekte oder Adorner. Als Argument wird ein DrawingContext-Objekt übergeben, das Methoden zum Zeichnen von Formen, für Texte, Bilder oder Videos zur Verfügung stellt.

Im folgenden Codebeispiel wird eine mögliche Implementierung für eine abgeleitete Panel-Klasse veranschaulicht.

// 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);
}


Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft