System.Drawing Espace de noms
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.