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 bidimensionnelles et vectorielles avancées.
Classes
| Nom | Description |
|---|---|
| AdjustableArrowCap |
Représente un capuchon de ligne en forme de flèche ajustable. Cette classe ne peut pas être héritée. |
| Blend |
Définit un modèle de fusion pour un LinearGradientBrush objet. 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 de couleurs dans un dégradé multicolore. Cette classe ne peut pas être héritée. |
| CustomLineCap |
Encapsule une limite de ligne personnalisée définie par l’utilisateur. |
| GraphicsContainer |
Représente les données internes d’un conteneur graphique. Cette classe est utilisée lors de l’enregistrement de l’état d’un Graphics objet à l’aide des méthodes et EndContainer(GraphicsContainer) des BeginContainer() méthodes. 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 |
Fournit la possibilité d’itérer via des sous-chemins dans un GraphicsPath et de tester les types de formes contenus dans chaque sous-chemin. Cette classe ne peut pas être héritée. |
| GraphicsState |
Représente l’état d’un Graphics objet. Cet objet est retourné par un appel aux Save() méthodes. Cette classe ne peut pas être héritée. |
| HatchBrush |
Définit un pinceau rectangulaire avec un style de hachure, 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 dégradé linéaire. Cette classe ne peut pas être héritée. |
| Matrix |
Encapsule une matrice affine de 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 qui composent un GraphicsPath objet. Cette classe ne peut pas être héritée. |
| PathGradientBrush |
Encapsule un Brush objet qui remplit l’intérieur d’un GraphicsPath objet avec un dégradé. Cette classe ne peut pas être héritée. |
| RegionData |
Encapsule les données qui composent un Region objet. Cette classe ne peut pas être héritée. |
Énumérations
| Nom | Description |
|---|---|
| CombineMode |
Spécifie la façon dont différentes régions de découpage peuvent être combinées. |
| CompositingMode |
Spécifie la façon dont les couleurs sources 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 sur les deux extrémités de chaque tiret d’une ligne en pointillés. |
| DashStyle |
Spécifie le style des traits pointillés dessinés avec un objet Pen. |
| FillMode |
Spécifie la façon dont l’intérieur d’un chemin fermé est rempli. |
| FlushIntention |
Spécifie si les commandes de la pile graphique sont arrêtées (vidées) immédiatement ou exécutées dès que possible. |
| HatchStyle |
Spécifie les différents modèles disponibles pour les objets HatchBrush. |
| InterpolationMode |
L’énumération InterpolationMode spécifie l’algorithme utilisé lorsque les images sont mises à l’échelle ou pivotées. |
| LinearGradientMode |
Spécifie la direction d’un dégradé linéaire. |
| LineCap |
Spécifie les styles de limite disponibles avec lesquels un objet Pen peut mettre fin à une ligne. |
| LineJoin |
Spécifie comment joindre des segments de courbe ou de ligne consécutifs dans une figure (sous-chemin) contenue dans un objet GraphicsPath. |
| MatrixOrder |
Spécifie l’ordre des opérations de transformation de matrice. |
| PathPointType |
Spécifie le type de point dans un objet GraphicsPath. |
| PenAlignment |
Spécifie l’alignement d’un objet Pen par rapport à la ligne théorique de largeur nulle. |
| PenType |
Spécifie le type de remplissage d’un objet Pen utilisé pour remplir des lignes. |
| PixelOffsetMode |
Spécifie le décalage des pixels pendant le rendu. |
| QualityMode |
Spécifie la qualité globale lors du rendu d’objets GDI+. |
| SmoothingMode |
Spécifie si le lissage (antialiasing) est appliqué aux lignes et courbes et aux bords des zones remplies. |
| WarpMode |
Spécifie le type de transformation de warp appliquée dans une méthode Warp. |
| WrapMode |
Spécifie comment une texture ou un dégradé est en mosaïque lorsqu’il est plus petit que la zone remplie. |
Remarques
Avertissement
L’espace System.Drawing de noms présente certaines limitations pour certains systèmes d’exploitation et types d’applications.
Sur Windows,
System.Drawingdépend de la bibliothèque native GDI+, fournie dans le cadre du système d’exploitation. Certaines références SKU Windows, comme 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, les exceptions sont levées au moment de l’exécution.Certains types de l’espace de noms
System.Drawings’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 , peuvent System.Drawing.Rectangleêtre utilisés dans n’importe quelle application.Dans .NET 5 et versions précédentes, le package NuGet System.Drawing.Common fonctionne sur Windows, Linux et macOS. Toutefois, il existe certaines 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 à partir du package System.Drawing.Common sur Linux et macOS, vous devez installer libgdiplus séparément. Pour plus d’informations, consultez Install .NET sur Linux ou Install .NET sur macOS.
Dans .NET 6 et versions ultérieures, le package NuGet System.Drawing.Common n’est pris en charge que 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 dans 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 GraphicsContainer les informations de rapport sur l’objet actuel Graphics .
GraphicsPath les classes représentent une série de lignes et de courbes. Les GraphicsPathIterator classes et PathData les classes 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 les classes vous permettent de remplir des formes avec un dégradé, ou un motif de hachure, respectivement. |
| - Énumération liée aux lignes | Les LineCap énumérations CustomLineCap et les énumérations vous permettent de spécifier des styles de limite pour une ligne. LineJoin L’énumération vous permet de spécifier la façon dont deux lignes sont jointes dans un chemin d’accès. 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. |
Avertissement
Les classes de l’espace de noms System.Drawing.Drawing2D 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’applications peut entraîner des problèmes inattendus, tels que des performances de service réduites et des exceptions d’exécution.