System.Drawing Espace de noms

Fournit l’accès aux fonctionnalités graphiques de base de GDI+. Les System.Drawing.Drawing2Despaces de noms , System.Drawing.Imaginget System.Drawing.Text fournissent des fonctionnalités plus avancées. Pour connaître les limitations, consultez la section Remarques.

Classes

Bitmap

Encapsule une bitmap GDI+, composée des données de pixels d’une image graphique et de ses attributs. Bitmap est un objet utilisé pour manipuler des images définies par des données de pixels.

BitmapSuffixInSameAssemblyAttribute

Spécifie que, en interprétant les déclarations ToolboxBitmapAttribute, l'assembly doit rechercher les ressources indiquées dans le même assembly, mais avec la valeur de configuration BitmapSuffix ajoutée au nom de fichier déclaré.

BitmapSuffixInSatelliteAssemblyAttribute

Spécifie que, en interprétant les déclarations ToolboxBitmapAttribute, l'assembly doit rechercher les ressources indiquées dans un assembly satellite, mais avec la valeur de configuration BitmapSuffix ajoutée au nom de fichier déclaré.

Brush

Définit les objets utilisés pour remplir l'intérieur des formes graphiques telles que les rectangles, les ellipses, les secteurs, les polygones et les tracés.

Brushes

Pinceaux (brush en anglais) pour toutes les couleurs standard. Cette classe ne peut pas être héritée.

BufferedGraphics

Fournit une mémoire tampon de graphiques pour la double mise en mémoire tampon.

BufferedGraphicsContext

Fournit des méthodes permettant de créer des mémoires tampons de graphiques qui peuvent être utilisées pour le mécanisme de double tampon.

BufferedGraphicsManager

Fournit l'accès au principal objet de contexte graphique mis en mémoire tampon pour le domaine d'application.

ColorConverter

Convertit les couleurs d'un type de données à un autre. Accédez à cette classe via TypeDescriptor.

ColorTranslator

Convertit les couleurs vers et à partir de structures Color GDI+. Cette classe ne peut pas être héritée.

Font

Définit un format spécifique pour le texte, notamment la police, la taille et les attributs de style. Cette classe ne peut pas être héritée.

FontConverter

Convertit les objets Font d'un type de données à un autre.

FontConverter.FontNameConverter

FontConverter.FontNameConverter est convertisseur de type qui est utilisé pour convertir un nom de police dans et à partir de plusieurs autres représentations.

FontConverter.FontUnitConverter

Convertit des unités de police vers et à partir d'autres types d'unités.

FontFamily

Définit un groupe de polices dont le design de base est similaire, mais qui comportent des variations de styles. Cette classe ne peut pas être héritée.

Graphics

Encapsule une surface de dessin GDI+. Cette classe ne peut pas être héritée.

Icon

Représente une icône Windows, qui est une petite image bitmap servant à représenter un objet. Les icônes peuvent être considérées comme des bitmaps transparentes, bien que leur taille soit définie par le système.

IconConverter

Convertit un objet Icon d'un type de données à un autre. Accédez à cette classe via l'objet TypeDescriptor.

Image

Classe de base abstraite qui fournit des fonctionnalités pour les classes descendantes Bitmap et Metafile.

ImageAnimator

Anime une image qui possède des frames basés sur l'heure.

ImageConverter

ImageConverter est une classe qui peut être utilisée pour convertir des objets Image d'un type de données à un autre. Accédez à cette classe via l'objet TypeDescriptor.

ImageFormatConverter

ImageFormatConverter est une classe qui peut être utilisée pour convertir des objets ImageFormat d'un type de données à un autre. Accédez à cette classe via l'objet TypeDescriptor.

Pen

Définit un objet utilisé pour dessiner des lignes et des courbes. Cette classe ne peut pas être héritée.

Pens

Stylets pour toutes les couleurs standard. Cette classe ne peut pas être héritée.

PointConverter

Convertit un objet Point d'un type de données à un autre.

RectangleConverter

Convertit des rectangles d'un type de données à un autre. Accédez à cette classe via TypeDescriptor.

Region

Décrit l'intérieur d'une forme graphique composée de rectangles et de chemins d'accès. Cette classe ne peut pas être héritée.

SizeConverter

La classe SizeConverter est utilisée pour convertir d'un type de données à un autre. Accédez à cette classe via l'objet TypeDescriptor.

SizeFConverter

Convertit les objets SizeF d'un type en un autre type.

SolidBrush

Définit un pinceau d'une seule couleur. Les pinceaux sont utilisés pour remplir des formes graphiques, telles que des rectangles, des ellipses, des secteurs, des polygones et des tracés. Cette classe ne peut pas être héritée.

StringFormat

Encapsule les informations relatives à la mise en page du texte (telles que l'alignement, l'orientation et les taquets de tabulation), les manipulations d'affichage (telles que l'insertion de points de sélection et la substitution des formes nationales de chiffres) et les fonctionnalités OpenType. Cette classe ne peut pas être héritée.

SystemBrushes

Chaque propriété de la classe SystemBrushes est un SolidBrush qui correspond à la couleur d'un élément d'affichage Windows.

SystemColors

Chaque propriété de la classe SystemColors est une structure Color qui est la couleur d'un élément d'affichage Windows.

SystemFonts

Spécifie les polices utilisées pour afficher le texte des éléments d'affichage Windows.

SystemIcons

Chaque propriété de la classe SystemIcons est un objet Icon destiné aux icônes du système Windows. Cette classe ne peut pas être héritée.

SystemPens

Chaque propriété de la classe SystemPens est un Pen qui correspond à la couleur d'un élément d'affichage Windows et dont la largeur est 1 pixel.

TextureBrush

Chaque propriété de la classe TextureBrush est un objet Brush qui utilise une image pour remplir l'intérieur d'une forme. Cette classe ne peut pas être héritée.

ToolboxBitmapAttribute

Vous permet de spécifier une icône représentant un contrôle dans un conteneur, tel que le Microsoft Visual Studio Form Designer.

Structures

CharacterRange

Spécifie une plage de positions de caractères dans une chaîne.

Color

Représente une couleur ARVB (alpha, rouge, vert, bleu).

Point

Représente une paire ordonnée de coordonnées x et y entières définissant un point dans un plan à deux dimensions.

PointF

Représente une paire ordonnée de coordonnées x et y en virgule flottante qui définit un point dans un plan à deux dimensions.

Rectangle

Stocke un ensemble de quatre entiers représentant l’emplacement et la taille d’un rectangle.

RectangleF

Stocke un ensemble de quatre nombres à virgule flottante représentant l'emplacement et la taille d'un rectangle. Pour des fonctions de région plus avancées, utilisez un objet Region.

Size

Stocke une paire ordonnée d'entiers qui spécifient un Height et Width.

SizeF

Stocke une paire ordonnée de nombres à virgule flottante, représentant généralement la largeur et la hauteur d'un rectangle.

Interfaces

IDeviceContext

Définit les méthodes permettant d'obtenir et de libérer un handle de contexte de périphérique Windows existant.

Énumérations

ContentAlignment

Spécifie l'alignement du contenu de la surface de dessin.

CopyPixelOperation

Détermine comment la couleur source dans une opération de copie de pixels se combine à la couleur de destination pour donner la couleur finale.

FontStyle

Spécifie les informations de style appliquées au texte.

GraphicsUnit

Spécifie l'unité de mesure pour les données spécifiées.

KnownColor

Spécifie les couleurs système connues.

RotateFlipType

Spécifie la valeur de rotation d'une image et l'axe utilisé pour retourner l'image.

StockIconId

Fournit des identificateurs d’icône à utiliser avec GetStockIcon(StockIconId, StockIconOptions).

StockIconOptions

Fournit des options d’utilisation avec GetStockIcon(StockIconId, StockIconOptions).

StringAlignment

Spécifie l'alignement d'une chaîne de texte par rapport à son rectangle de mise en page.

StringDigitSubstitute

L'énumération StringDigitSubstitute spécifie comment remplacer des chiffres dans une chaîne en fonction des paramètres régionaux ou de la langue d'un utilisateur.

StringFormatFlags

Spécifie des informations d'affichage et relatives à la disposition pour des chaînes de texte.

StringTrimming

Spécifie la façon de rogner des caractères d'une chaîne qui ne s'ajuste pas complètement à une forme de mise en forme.

StringUnit

Spécifie les unités de mesure d'une chaîne de texte.

Délégués

Graphics.DrawImageAbort

Fournit une méthode de rappel pour déterminer à quel moment la méthode DrawImage doit prématurément annuler l'exécution et interrompre le dessin d'une image.

Graphics.EnumerateMetafileProc

Fournit une méthode de rappel pour la méthode EnumerateMetafile.

Image.GetThumbnailImageAbort

Fournit une méthode de rappel pour déterminer à quel moment la méthode GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr) doit prématurément annuler l'exécution.

Remarques

Attention

L’espace System.Drawing de noms présente certaines limitations pour certains systèmes d’exploitation et types d’applications.

  • Sur Windows, System.Drawing dépend de la bibliothèque native GDI+, qui est fournie dans le cadre du système d’exploitation. Certaines références SKU Windows, telles que Windows Server Core ou Windows Nano, n’incluent pas cette bibliothèque native dans le cadre du système d’exploitation. Si vous utilisez cet espace de noms et que la bibliothèque ne peut pas être chargée, des exceptions sont levées au moment de l’exécution.

  • Certains types de l’espace System.Drawing de noms s’appuient sur GDI+, qui n’est pas pris en charge dans les services Windows et les applications ASP.NET Core et ASP.NET. Ces types se trouvent dans le package NuGet System.Drawing.Common et incluent System.Drawing.Bitmap et System.Drawing.Font. Toutefois, les types primitifs dans l’espace de noms, tels que System.Drawing.Color, System.Drawing.Size, System.Drawing.Pointet System.Drawing.Rectangle, peuvent être utilisés dans n’importe quelle application.

  • Dans .NET 5 et les versions antérieures, le package NuGet System.Drawing.Common fonctionne sur Windows, Linux et macOS. Toutefois, il existe des différences de plateforme. Sur Linux et macOS, la fonctionnalité GDI+ est implémentée par la bibliothèque libgdiplus ). Cette bibliothèque n’est pas installée par défaut dans la plupart des distributions Linux et ne prend pas en charge toutes les fonctionnalités de GDI+ sur Windows et macOS. Il existe également des plateformes où libgdiplus n’est pas disponible du tout. Pour utiliser les types du package System.Drawing.Common sur Linux et macOS, vous devez installer libgdiplus séparément. Pour plus d’informations, consultez Installer .NET sur Linux ou Installer .NET sur macOS.

  • Dans .NET 6 et versions ultérieures, le package NuGet System.Drawing.Common est uniquement pris en charge sur les systèmes d’exploitation Windows. Pour plus d’informations, consultez System.Drawing.Common uniquement pris en charge sur Windows.

Si vous ne pouvez pas utiliser System.Drawing avec votre application, les alternatives recommandées incluent ImageSharp, SkiaSharp, Windows Imaging Components et Microsoft.Maui.Graphics.

La Graphics classe fournit des méthodes de dessin sur le périphérique d’affichage. Des classes telles que Rectangle et Point encapsulent les primitives GDI+. La Pen classe est utilisée pour dessiner des lignes et des courbes, tandis que les classes dérivées de la classe Brush abstraite sont utilisées pour remplir les intérieurs des formes.