System.Drawing Namespace

Referenz

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Dieser Namespace ermöglicht den Zugriff auf grundlegende GDI+-Grafikfunktionen. Die System.Drawing.Drawing2DNamespaces , System.Drawing.Imagingund System.Drawing.Text bieten erweiterte Funktionen. Einschränkungen finden Sie im Abschnitt Hinweise.

Klassen

Bitmap	Kapselt eine GDI+-Bitmap, die aus den Pixeldaten für eine Grafik und deren Attributen besteht. Eine Bitmap wird für die Arbeit mit Bildern verwendet, die durch Pixeldaten definiert sind.
BitmapSuffixInSameAssemblyAttribute	Bezeichnet, dass beim Interpretieren der Deklarationen ToolboxBitmapAttribute die Assembly nach den angezeigten Ressourcen in der gleichen Assembly suchen sollte, aber mit der Anfügung des Konfigurationswertes BitmapSuffix an den deklarierten Dateinamen.
BitmapSuffixInSatelliteAssemblyAttribute	Bezeichnet, dass beim Interpretieren der Deklarationen ToolboxBitmapAttribute die Assembly nach den angezeigten Ressourcen in einer Satellitenassembly suche sollte, aber mit der Anfügung des Konfigurationswertes BitmapSuffix an den deklarierten Dateinamen.
Brush	Definiert Objekte, die zum Füllen des Inneren von Grafikformen wie Rechtecken, Ellipsen, Kreisen, Vielecken und Pfaden verwendet werden.
Brushes	Pinsel für alle Standardfarben. Diese Klasse kann nicht vererbt werden.
BufferedGraphics	Stellt einen Grafikpuffer für doppelte Pufferung bereit.
BufferedGraphicsContext	Stellt Methoden für das Erstellen von Grafikpuffern bereit, die für die doppelte Pufferung verwendet werden können.
BufferedGraphicsManager	Ermöglicht den Zugriff auf das gepufferte Hauptgrafikkontext-Objekt für die Anwendungsdomäne.
ColorConverter	Konvertiert Farben aus einem Datentyp in einen anderen. Greifen Sie auf diese Klasse über TypeDescriptor zu.
ColorTranslator	Übersetzt Farben aus und in GDI+-Color-Strukturen. Diese Klasse kann nicht vererbt werden.
Font	Definiert ein bestimmtes Format für Text, einschließlich der Attribute für Schriftart, Schriftgrad und Schriftschnitt. Diese Klasse kann nicht vererbt werden.
FontConverter	Konvertiert Font-Objekte aus einem Datentyp in einen anderen.
FontConverter.FontNameConverter	FontConverter.FontNameConverter ist ein Typkonverter, der verwendet wird, um einen Schriftartnamen in und aus verschiedenen anderen Darstellungen zu konvertieren.
FontConverter.FontUnitConverter	Konvertiert Schriftarteinheiten in und aus anderen Einheitstypen.
FontFamily	Definiert eine Gruppe von Schriftarten mit ähnlichem Grundformat und bestimmten Unterschieden beim Schriftschnitt. Diese Klasse kann nicht vererbt werden.
Graphics	Kapselt eine GDI+-Zeichenoberfläche. Diese Klasse kann nicht vererbt werden.
Icon	Stellt ein Windows-Symbol dar, bei dem es sich um ein Bitmap-Bild zur Darstellung eines Objekts handelt. Symbole lassen sich als transparente Bitmaps vorstellen, deren Größe jedoch durch das System bestimmt wird.
IconConverter	Konvertiert ein Icon-Objekt aus einem Datentyp in einen anderen. Greifen Sie auf diese Klasse über das TypeDescriptor-Objekt zu.
Image	Eine abstrakte Basisklasse, die Funktionen für die von Bitmap und Metafile abgeleiteten Klassen bereitstellt.
ImageAnimator	Animiert ein Bild, das zeitbasierte Frames enthält.
ImageConverter	ImageConverter ist eine Klasse, mit der Image-Objekte in andere Datentypen konvertiert werden können. Greifen Sie auf diese Klasse über das TypeDescriptor-Objekt zu.
ImageFormatConverter	ImageFormatConverter ist eine Klasse, mit der ImageFormat-Objekte in andere Datentypen konvertiert werden können. Greifen Sie auf diese Klasse über das TypeDescriptor-Objekt zu.
Pen	Definiert ein Objekt, mit dem Linien und Kurven gezeichnet werden. Diese Klasse kann nicht vererbt werden.
Pens	Stifte für alle Standardfarben. Diese Klasse kann nicht vererbt werden.
PointConverter	Konvertiert ein Point-Objekt aus einem Datentyp in einen anderen.
RectangleConverter	Konvertiert Rechtecke aus einem Datentyp in einen anderen. Greifen Sie auf diese Klasse über TypeDescriptor zu.
Region	Beschreibt das Innere einer grafischen Form, die aus Rechtecken und Pfaden zusammengesetzt ist. Diese Klasse kann nicht vererbt werden.
SizeConverter	Mit der SizeConverter-Klasse können Datentypen in andere Datentypen konvertiert werden. Greifen Sie auf diese Klasse über das TypeDescriptor-Objekt zu.
SizeFConverter	Konvertiert SizeF-Objekte aus einem Typ in einen anderen.
SolidBrush	Definiert einen einfarbigen Pinsel. Pinsel werden zum Füllen von Grafikformen verwendet, z. B. von Rechtecken, Ellipsen, Kreisen, Vielecken und Pfaden. Diese Klasse kann nicht vererbt werden.
StringFormat	Kapselt Informationen für das Textlayout (z. B. Text- und Seitenausrichtung und Tabstopps), Anzeigeänderungen (z. B. das Einfügen von Auslassungszeichen und das Ersetzen nationaler Zahlenformate) und OpenType-Features. Diese Klasse kann nicht vererbt werden.
SystemBrushes	Jede Eigenschaft der SystemBrushes-Klasse ist ein SolidBrush mit der Farbe eines Windows-Anzeigeelements.
SystemColors	Jede Eigenschaft der SystemColors-Klasse ist eine Color-Struktur mit der Farbe eines Windows-Anzeigeelements.
SystemFonts	Gibt die Schriftarten an, die zum Anzeigen von Text in Windows-Anzeigeelementen verwendet werden.
SystemIcons	Jede Eigenschaft der SystemIcons-Klasse ist ein Icon-Objekt für im gesamten System verwendete Windows-Symbole. Diese Klasse kann nicht vererbt werden.
SystemPens	Jede Eigenschaft der SystemPens-Klasse ist ein Pen mit der Farbe eines Windows-Anzeigeelements und einer Breite von 1 Pixel.
TextureBrush	Jede Eigenschaft der TextureBrush-Klasse ist ein Brush-Objekt, das das Innere einer Form mit einem Bild ausfüllt. Diese Klasse kann nicht vererbt werden.
ToolboxBitmapAttribute	Ermöglicht Ihnen, ein Symbol anzugeben, das ein Steuerelement in einem Container darstellt, z. B. in Microsoft Visual Studio Form Designer.

Strukturen

CharacterRange	Gibt einen Bereich von Zeichenpositionen in einer Zeichenfolge an.
Color	Stellt eine ARGB-Farbe (Alpha, Rot, Grün, Blau) dar.
Point	Stellt ein geordnetes Paar von x- und y-Koordinaten als ganze Zahlen dar, das einen Punkt in einem zweidimensionalen Raum definiert.
PointF	Stellt ein geordnetes Paar von x- und y-Koordinaten als Gleitkommazahlen dar, das einen Punkt in einem zweidimensionalen Raum definiert.
Rectangle	Speichert einen Satz von vier Integerwerten, die die Position und Größe eines Rechtecks angeben.
RectangleF	Speichert einen Satz von vier Gleitkommazahlen, die die Position und Größe eines Rechtecks angeben. Verwenden Sie für erweiterte Bereichsfunktionen ein Region-Objekt.
Size	Speichert ein geordnetes Paar ganzer Zahlen, die eine Height und Width angeben.
SizeF	Speichert ein geordnetes Paar von Gleitkommazahlen, i. d. R. die Breite und Höhe eines Rechtecks.

Schnittstellen

IDeviceContext

Definiert Methoden zum Abrufen und Freigeben eines vorhandenen Handles für einen Windows-Gerätekontext.

Enumerationen

ContentAlignment	Gibt die Ausrichtung des Inhalts auf der Zeichenoberfläche an.
CopyPixelOperation	Bestimmt, wie die Quellfarbe beim Kopieren von Pixeln mit der Zielfarbe zu einer Endfarbe kombiniert wird.
FontStyle	Gibt Informationen zu dem auf den Text angewendeten Schriftschnitt an.
GraphicsUnit	Gibt die Maßeinheit für die angegebenen Daten an.
KnownColor	Gibt die bekannten Systemfarben an.
RotateFlipType	Gibt an, wie weit ein Bild gedreht und um welche Achse es gekippt werden soll.
StockIconId	Stellt Symbolbezeichner für die Verwendung mit GetStockIcon(StockIconId, StockIconOptions)bereit.
StockIconOptions	Stellt Optionen für die Verwendung mit GetStockIcon(StockIconId, StockIconOptions)bereit.
StringAlignment	Gibt die Ausrichtung einer Textzeichenfolge relativ zum zugehörigen Layoutrechteck an.
StringDigitSubstitute	Die StringDigitSubstitute-Enumeration gibt an, wie die Ziffern in einer Zeichenfolge gemäß dem Gebietsschema oder der Sprache des Benutzers ersetzt werden sollen.
StringFormatFlags	Gibt die Anzeige- und Layoutinformationen für Textzeichenfolgen an.
StringTrimming	Gibt an, wie Zeichen in einer Zeichenfolge gekürzt werden, die nicht vollständig in eine Layoutform passt.
StringUnit	Gibt die Maßeinheiten für eine Textzeichenfolge an.

Delegaten

Graphics.DrawImageAbort	Stellt eine Rückrufmethode bereit, mit der bestimmt wird, wann die DrawImage-Methode die Ausführung vorzeitig abbrechen und aufhören soll, ein Bild zu zeichnen.
Graphics.EnumerateMetafileProc	Stellt eine Rückrufmethode für die EnumerateMetafile-Methode bereit.
Image.GetThumbnailImageAbort	Stellt eine Rückrufmethode bereit, mit der bestimmt wird, wann die GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr)-Methode die Ausführung vorzeitig abbrechen soll.

Hinweise

Achtung

Der System.Drawing Namespace weist einige Einschränkungen für bestimmte Betriebssysteme und Anwendungstypen auf.

Unter Windows System.Drawing hängt von der nativen GDI+-Bibliothek ab, die als Teil des Betriebssystems ausgeliefert wird. Einige Windows-SKUs, z. B. Windows Server Core oder Windows Nano, enthalten diese native Bibliothek nicht als Teil des Betriebssystems. Wenn Sie diesen Namespace verwenden und die Bibliothek nicht geladen werden kann, werden zur Laufzeit Ausnahmen ausgelöst.
Einige Typen im System.Drawing Namespace basieren auf GDI+, das in Windows-Diensten und ASP.NET Core- und ASP.NET-Apps nicht unterstützt wird. Diese Typen befinden sich im NuGet-Paket System.Drawing.Common und enthalten System.Drawing.Bitmap und System.Drawing.Font. Primitive Typen im Namespace wie System.Drawing.Color, System.Drawing.Size System.Drawing.Point, und System.Drawing.Rectanglekönnen jedoch in jeder Anwendung verwendet werden.
In .NET 5 und früheren Versionen funktioniert das NuGet-Paket System.Drawing.Common unter Windows, Linux und macOS. Es gibt jedoch einige Plattformunterschiede. Unter Linux und macOS wird die GDI+-Funktionalität von der Bibliothek libgdiplus) implementiert. Diese Bibliothek ist in den meisten Linux-Distributionen nicht standardmäßig installiert und unterstützt nicht alle Funktionen von GDI+ unter Windows und macOS. Es gibt auch Plattformen, auf denen libgdiplus überhaupt nicht verfügbar ist. Um Typen aus dem System.Drawing.Common-Paket unter Linux und macOS zu verwenden, müssen Sie libgdiplus separat installieren. Weitere Informationen finden Sie unter Installieren von .NET unter Linux oder Installieren von .NET unter macOS.
In .NET 6 und höheren Versionen wird das NuGet-Paket System.Drawing.Common nur unter Windows-Betriebssystemen unterstützt. Weitere Informationen finden Sie unter System.Drawing.Common wird nur unter Windows unterstützt.

Wenn Sie die Anwendung nicht verwenden System.Drawing können, werden ImageSharp, SkiaSharp, Windows Imaging Components und Microsoft.Maui.Graphics empfohlen.

Die Graphics -Klasse stellt Methoden zum Zeichnen auf dem Anzeigegerät bereit. Klassen wie Rectangle und Point kapseln GDI+-Grundtypen. Die Pen -Klasse wird verwendet, um Linien und Kurven zu zeichnen, während von der abstrakten Klasse Brush abgeleitete Klassen verwendet werden, um die Innenbereiche von Formen zu füllen.

Teilen über