System.Drawing Espace de noms

Référence

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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.