System.Drawing.Drawing2D Espace de noms

Fournit des fonctionnalités graphiques vectorielles et à deux dimensions avancées.

Classes

AdjustableArrowCap

Représente un embout de ligne réglable en forme de flèche. Cette classe ne peut pas être héritée.

Blend

Définit un modèle de mélange pour un objet LinearGradientBrush. Cette classe ne peut pas être héritée.

ColorBlend

Définit des tableaux de couleurs et de positions utilisés pour interpoler le mélange des couleurs dans un dégradé multicolore. Cette classe ne peut pas être héritée.

CustomLineCap

Encapsule un embout de ligne personnalisé défini par l'utilisateur.

GraphicsContainer

Représente les données internes d'un conteneur de graphiques. Cette classe est utilisée lors de l'enregistrement de l'état d'un objet Graphics à l'aide des méthodes BeginContainer() et EndContainer(GraphicsContainer). Cette classe ne peut pas être héritée.

GraphicsPath

Représente une série de lignes et de courbes connectées. Cette classe ne peut pas être héritée.

GraphicsPathIterator

Permet d'itérer au sein de sous-tracés dans un GraphicsPath et de tester les types de formes contenus dans chaque sous-tracé. Cette classe ne peut pas être héritée.

GraphicsState

Représente l'état d'un objet Graphics. Cet objet est retourné par un appel aux méthodes Save(). Cette classe ne peut pas être héritée.

HatchBrush

Définit un pinceau rectangulaire avec un style de hachurage, une couleur de premier plan et une couleur d'arrière-plan. Cette classe ne peut pas être héritée.

LinearGradientBrush

Encapsule un Brush avec un dégradé linéaire. Cette classe ne peut pas être héritée.

Matrix

Encapsule une matrice affine 3-par-3 qui représente une transformation géométrique. Cette classe ne peut pas être héritée.

PathData

Contient les données graphiques composant un objet GraphicsPath. Cette classe ne peut pas être héritée.

PathGradientBrush

Encapsule un objet Brush qui remplit l'intérieur d'un objet GraphicsPath avec un dégradé. Cette classe ne peut pas être héritée.

RegionData

Encapsule les données composant un objet Region. Cette classe ne peut pas être héritée.

Énumérations

CombineMode

Spécifie la façon de combiner différentes régions de découpage.

CompositingMode

Spécifie la façon dont les couleurs source sont combinées avec les couleurs d'arrière-plan.

CompositingQuality

Spécifie le niveau de qualité à utiliser pendant la composition.

CoordinateSpace

Spécifie le système à utiliser lors de l'évaluation des coordonnées.

DashCap

Spécifie le type de forme graphique à utiliser aux deux extrémités de chaque tiret d'une ligne discontinue.

DashStyle

Spécifie le style des lignes discontinues dessinées à l'aide d'un objet Pen.

FillMode

Spécifie la façon dont l'intérieur d'un tracé fermé est rempli.

FlushIntention

Spécifie si les commandes de la pile de graphiques sont terminées (vidées) immédiatement ou exécutées dès que possible.

HatchStyle

Spécifie différents motifs disponibles pour les objets HatchBrush.

InterpolationMode

L'énumération InterpolationMode spécifie l'algorithme utilisé lorsque des images sont mises à l'échelle ou pivotées.

LinearGradientMode

Spécifie l'orientation d'un dégradé linéaire.

LineCap

Spécifie les styles d'embouts avec lesquels un objet Pen peut terminer des lignes.

LineJoin

Spécifie la façon de joindre des segments de ligne ou de courbes qui se suivent dans une figure (section) d'un objet GraphicsPath.

MatrixOrder

Spécifie l'ordre utilisé durant les opérations de matrices de transformation.

PathPointType

Spécifie le type des points d'un objet GraphicsPath.

PenAlignment

Spécifie l'alignement d'un objet Pen par rapport à la ligne théorique d'une épaisseur égale à zéro.

PenType

Spécifie le type de remplissage à l'aide duquel un objet Pen remplit les lignes.

PixelOffsetMode

Spécifie la façon dont les pixels doivent être décalés lors du rendu.

QualityMode

Spécifie la qualité globale du rendu d'objets GDI+.

SmoothingMode

Spécifie si le lissage (anticrénelage) est appliqué aux lignes, aux courbes et aux bords des zones remplies.

WarpMode

Spécifie le type de distorsion appliqué dans une méthode Warp.

WrapMode

Spécifie comment une texture ou un dégradé est disposé en mosaïque lorsqu'il est plus petit que la zone à remplir.

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 des 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.

Le tableau suivant répertorie certaines des classes et énumérations importantes de l’espace System.Drawing.Drawing2D de noms, regroupées en catégories.

Catégorie de classe Détails
- Chemins graphiques et graphiques Les GraphicsState classes et rapportent GraphicsContainer des informations sur l’objet actuel Graphics . GraphicsPath les classes représentent une série de lignes et de courbes. Les GraphicsPathIterator classes et PathData fournissent des informations détaillées sur le contenu d’un GraphicsPath objet.
- Types liés à la matrice et à la transformation La Matrix classe représente une matrice pour les transformations géométriques. L’énumération MatrixOrder spécifie l’ordre des transformations de matrice.
- Classes de pinceau Les PathGradientBrush classes et HatchBrush vous permettent de remplir des formes à l’aide d’un dégradé ou d’un modèle de hachure, respectivement.
- Énumération liée aux lignes Les LineCap énumérations et CustomLineCap vous permettent de spécifier des styles de limite pour une ligne. L’énumération , LineJoin vous permet de spécifier la façon dont deux lignes sont jointes dans un chemin. L’énumération PenAlignment vous permet de spécifier l’alignement de la pointe de dessin lorsque vous dessinez une ligne. L’énumération PenType spécifie le modèle dont une ligne doit être remplie.
- Énumérations liées au remplissage des formes et des chemins L’énumération HatchStyle spécifie les styles de remplissage d’un HatchBrush. La Blend classe spécifie un modèle de fusion pour un LinearGradientBrush. L’énumération FillMode spécifie le style de remplissage d’un GraphicsPath.

Attention

Les classes de l’espace System.Drawing.Drawing2D de noms ne sont pas prises en charge pour une utilisation dans un service Windows ou ASP.NET. La tentative d’utilisation de ces classes dans l’un de ces types d’application peut générer des problèmes inattendus, tels que des performances de service réduites et des exceptions d’exécution.

Voir aussi