Steuerelemente mit integrierter Ownerdrawing-Unterstützung

Artikel
05/04/2023

Ownerdrawing in Windows Forms, das auch als benutzerdefiniertes Zeichnen bezeichnet, ist ein Verfahren zum Ändern der Darstellung bestimmter Steuerelemente.

Hinweis

Mit dem Begriff „Steuerelement“ werden in diesem Thema Klassen bezeichnet, die entweder von Control oder Component abgeleitet sind.

Normalerweise werden Zeichnungsvorgänge in Windows automatisch verarbeitet, indem Eigenschafteneinstellungen wie BackColor verwendet werden, um die Darstellung eines Steuerelements zu bestimmen. Beim Ownerdrawing übernehmen Sie das Zeichnen und können Darstellungselemente ändern, die nicht mithilfe von Eigenschaften angepasst werden können. Beispielsweise kann bei zahlreichen Steuerelementen die Farbe des angezeigten Textes festgelegt werden. Dabei ist die Anzeige jedoch auf eine Farbe beschränkt. Das Ownerdrawing bietet beispielsweise die Möglichkeit, einen Teil des Textes schwarz und den anderen rot anzuzeigen.

In der Praxis ähnelt Ownerdrawing dem Zeichnen von Grafiken auf einem Formular. Beispielsweise können Sie Grafikmethoden in einem Handler für das Paint-Ereignis des Formulars verwenden, um ein ListBox-Steuerelement zu emulieren. Zur Behandlung der gesamten Benutzerinteraktion müssten Sie jedoch eigenen Code schreiben. Beim Ownerdrawing verwendet das Steuerelement den von Ihnen geschriebenen Code, um den Inhalt zu zeichnen, behält im Übrigen aber seine gesamte systeminterne Funktionalität bei. Sie können Grafikmethoden zum Zeichnen der einzelnen Elemente im Steuerelement oder zum Anpassen einiger Aspekte einzelner Elemente verwenden, während für andere Aspekte einzelner Elemente wiederum die Standarddarstellung übernommen werden kann.

Ownerdrawing in Windows Forms-Steuerelementen

Um Ownerdrawing in Steuerelementen auszuführen, die diese Art des Zeichnens unterstützen, legen Sie normalerweise eine Eigenschaft fest und behandeln mindestens ein Ereignis.

Die meisten Steuerelemente mit Ownerdrawing-Unterstützung verfügen über die OwnerDraw-Eigenschaft oder DrawMode-Eigenschaft, die angibt, ob das Steuerelement eines oder mehrere zeichnungsbezogene Ereignisse auslöst, sobald es gezeichnet wird.

Zu den Steuerelementen, die keine OwnerDraw-Eigenschaft oder DrawMode-Eigenschaft aufweisen, gehört das DataGridView-Steuerelement, das automatisch ausgelöste Zeichnungsereignisse bereitstellt, sowie das ToolStrip-Steuerelement, das unter Verwendung einer externen Renderklasse gezeichnet wird, die eigene zeichnungsbezogene Ereignisse aufweist.

Es stehen viele verschiedene Arten von Zeichnungsereignissen zur Verfügung. Ein typisches Zeichnungsereignis tritt jedoch auf, wenn ein einzelnes Element innerhalb eines Steuerelements gezeichnet werden soll. Der Ereignishandler empfängt ein EventArgs-Objekt mit Informationen zum gezeichneten Element sowie zu den Tools, die zum Zeichnen verwendet werden können. Dieses Objekt enthält üblicherweise die Indexnummer des Elements innerhalb seiner übergeordneten Sammlung, ein Rectangle, das die Begrenzung des Anzeigebereichs für das Element angibt, sowie ein Graphics-Objekt zum Aufrufen von Zeichnungsmethoden. Bei einigen Ereignissen umfasst das EventArgs-Objekt zusätzliche Informationen zum Element sowie zu den Methoden, die aufgerufen werden können, um einige Aspekte des Elements in der Standarddarstellung zu zeichnen, z. B. den Hintergrund oder ein Fokusrechteck.

Zum Erstellen eines wiederverwendbaren Steuerelements, das Ownerdrawing-Anpassungen enthält, erstellen Sie eine neue Klasse, die von einer Steuerelementklasse mit Ownerdrawing-Unterstützung abgeleitet ist. Anstatt Zeichnungsereignisse zu behandeln, sollten Sie Ownerdrawing-Code in Überschreibungen für mindestens eine geeignete OnEventName-Methode in der neuen Klasse einfügen. Stellen Sie in diesem Fall sicher, dass die OnEventName-Methoden der Basisklasse aufgerufen werden, damit Benutzer des Steuerelements Ownerdrawing-Ereignisse behandeln und weitere Anpassungen vornehmen können.

Die folgenden Windows Forms-Steuerelemente unterstützen Ownerdrawing in allen Versionen von .NET Framework:

ListBox
ComboBox
MenuItem (von MainMenu und ContextMenu verwendet)
TabControl

Die folgenden Steuerelemente unterstützen Ownerdrawing nur in .NET Framework 2.0:

Die folgenden Steuerelemente unterstützen Ownerdrawing und sind neu in .NET Framework 2.0:

Die folgenden Abschnitte enthalten zusätzliche Details zu jedem dieser Steuerelemente.

Die Steuerelemente ListBox und ComboBox

Die Steuerelemente ListBox und ComboBox bieten die Möglichkeit, einzelne Elemente im Steuerelement entweder in derselben oder verschiedenen Größen zu zeichnen.

Hinweis

Obwohl das CheckedListBox-Steuerelement vom ListBox-Steuerelement abgeleitet ist, unterstützt es Ownerdrawning nicht.

Um alle Elemente in derselben Größe zu zeichnen, legen Sie die DrawMode-Eigenschaft auf OwnerDrawFixed fest und behandeln das DrawItem-Ereignis.

Um alle Elemente mit unterschiedlichen Größen zu zeichnen, legen Sie die DrawMode-Eigenschaft auf OwnerDrawVariable fest und behandeln die Ereignisse MeasureItem und DrawItem. Mit dem MeasureItem-Ereignis können Sie die Größe eines Elements angeben, bevor das DrawItem-Ereignis für das jeweilige Element auftritt.

Weitere Informationen, einschließlich Codebeispiele, finden Sie unter den folgenden Themen:

MenuItem-Komponente

Die MenuItem-Komponente steht für ein einzelnes Menüelement in der Komponente MainMenu oder ContextMenu.

Um MenuItem zu zeichnen, legen Sie die zugehörige OwnerDraw-Eigenschaft auf true fest und behandeln das zugehörige DrawItem-Ereignis. Um die Größe des Menüelements anzupassen, bevor das DrawItem-Ereignis auftritt, behandeln Sie das MeasureItem-Ereignis des Elements.