System.Drawing.Drawing2D 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 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.