System.Drawing Namespace

Dieser Namespace ermöglicht den Zugriff auf grundlegende GDI+-Grafikfunktionen. Die System.Drawing.Drawing2DSystem.Drawing.Imaging Namespaces , und 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.

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.

  • Bei Windows hängt System.Drawing von der nativen Bibliothek GDI+ ab, die als Teil des Betriebssystems ausgeliefert wird. Einige Windows-SKUs wie 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+, was in Windows Diensten und ASP.NET Core und ASP.NET-Apps nicht unterstützt wird. Diese Typen befinden sich im System.Drawing.Common NuGet-Paket und enthalten System.Drawing.Bitmap und System.Drawing.Font . Primitive Typen im Namespace, z. B. , , und , können jedoch System.Drawing.Color in jeder Anwendung verwendet System.Drawing.Size System.Drawing.Point System.Drawing.Rectangle werden.

  • In .NET 5 und früheren Versionen funktioniert das System.Drawing.Common NuGet-Paket 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öher wird das System.Drawing.Common NuGet-Paket nur unter Windows Betriebssystemen unterstützt. Weitere Informationen finden Sie unter System.Drawing.Common wird nur für Windows unterstützt.

Wenn Sie nicht mit Ihrer Anwendung verwenden können, werden unter System.Drawing anderem ImageSharp, SkiaSharp, Windows Imaging Componentsund Microsoft.Bildern.Graphicsempfohlen.

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