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.
Assembly: PresentationCore (in PresentationCore.dll)
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.
