System.Drawing Spazio dei nomi

Fornisce l'accesso alle funzionalità grafiche di base GDI+ . Gli System.Drawing.Drawing2Dspazi dei nomi , System.Drawing.Imaginge System.Drawing.Text offrono funzionalità più avanzate. Per le limitazioni, vedere la sezione Osservazioni.

Classi

Nome	Descrizione
Bitmap	Incapsula una bitmap GDI+ costituita dai dati pixel per un'immagine grafica e i relativi attributi. Un Bitmap oggetto è un oggetto utilizzato per lavorare con immagini definite dai dati pixel.
BitmapSuffixInSameAssemblyAttribute	Specifica che, quando si interpretano ToolboxBitmapAttribute dichiarazioni, l'assembly deve cercare le risorse indicate nello stesso assembly, ma con il valore di configurazione BitmapSuffix aggiunto al nome di file dichiarato.
BitmapSuffixInSatelliteAssemblyAttribute	Specifica che, quando si interpretano le dichiarazioni di ToolboxBitmapAttribute, l'assembly deve cercare le risorse indicate in un assembly satellite, ma con il valore di configurazione BitmapSuffix aggiunto al nome di file dichiarato.
Brush	Definisce gli oggetti utilizzati per riempire gli interni di forme grafiche, ad esempio rettangoli, puntini di sospensione, pie, poligoni e percorsi.
Brushes	Pennelli per tutti i colori standard. La classe non può essere ereditata.
BufferedGraphics	Fornisce un buffer grafico per il doppio buffer.
BufferedGraphicsContext	Fornisce metodi per la creazione di buffer grafici che possono essere usati per il doppio buffering.
BufferedGraphicsManager	Fornisce l'accesso all'oggetto contesto grafico memorizzato nel buffer principale per il dominio applicazione.
ColorConverter	Converte i colori da un tipo di dati a un altro. Accedere a questa classe tramite il TypeDescriptor.
ColorTranslator	Converte i colori da e verso strutture GDI+ Color . La classe non può essere ereditata.
Font	Definisce un formato specifico per il testo, inclusi gli attributi di tipo carattere, dimensioni e stile. La classe non può essere ereditata.
FontConverter	Converte Font oggetti da un tipo di dati a un altro.
FontConverter.FontNameConverter	FontConverter.FontNameConverter è un convertitore di tipi utilizzato per convertire un nome di carattere in e da varie altre rappresentazioni.
FontConverter.FontUnitConverter	Converte le unità di carattere in e da altri tipi di unità.
FontFamily	Definisce un gruppo di visi di tipo con un design di base simile e alcune variazioni negli stili. La classe non può essere ereditata.
Graphics	Incapsula una superficie di disegno GDI+. La classe non può essere ereditata.
Icon	Rappresenta un'icona Windows, ovvero un'immagine bitmap di piccole dimensioni utilizzata per rappresentare un oggetto. Le icone possono essere considerate come bitmap trasparenti, anche se le dimensioni sono determinate dal sistema.
IconConverter	Converte un Icon oggetto da un tipo di dati a un altro. Accedere a questa classe tramite l'oggetto TypeDescriptor.
Image	Classe base astratta che fornisce funzionalità per le Bitmap classi discendenti e Metafile .
ImageAnimator	Anima un'immagine con fotogrammi basati sul tempo.
ImageConverter	ImageConverter è una classe che può essere usata per convertire Image oggetti da un tipo di dati a un altro. Accedere a questa classe tramite l'oggetto TypeDescriptor.
ImageFormatConverter	ImageFormatConverter è una classe che può essere usata per convertire ImageFormat oggetti da un tipo di dati a un altro. Accedere a questa classe tramite l'oggetto TypeDescriptor.
Pen	Definisce un oggetto utilizzato per disegnare linee e curve. La classe non può essere ereditata.
Pens	Penne per tutti i colori standard. La classe non può essere ereditata.
PointConverter	Converte un oggetto Point da un tipo di dati a un altro.
RectangleConverter	Converte i rettangoli da un tipo di dati a un altro. Accedere a questa classe tramite il TypeDescriptor.
Region	Descrive l'interno di una forma grafica composta da rettangoli e percorsi. La classe non può essere ereditata.
SizeConverter	La classe SizeConverter viene usata per convertire da un tipo di dati a un altro. Accedere a questa classe tramite l'oggetto TypeDescriptor.
SizeFConverter	Converte SizeF oggetti da un tipo a un altro.
SolidBrush	Definisce un pennello di un singolo colore. I pennelli vengono usati per riempire forme grafiche, ad esempio rettangoli, ellissi, pie, poligoni e percorsi. La classe non può essere ereditata.
StringFormat	Incapsula le informazioni sul layout del testo (ad esempio allineamento, orientamento e tabulazioni) visualizzano manipolazioni (ad esempio l'inserimento dei puntini di sospensione e la sostituzione delle cifre nazionali) e le funzionalità OpenType. La classe non può essere ereditata.
SystemBrushes	Ogni proprietà della SystemBrushes classe è un SolidBrush oggetto che rappresenta il colore di un elemento di visualizzazione di Windows.
SystemColors	Ogni proprietà della SystemColors classe è una Color struttura che rappresenta il colore di un elemento di visualizzazione di Windows.
SystemFonts	Specifica i tipi di carattere utilizzati per visualizzare il testo in Windows elementi di visualizzazione.
SystemIcons	Ogni proprietà della classe è un oggetto />
SystemPens	Ogni proprietà della classe SystemPens è un Pen che rappresenta il colore di un elemento di visualizzazione Windows e che ha una larghezza di 1 pixel.
TextureBrush	Ogni proprietà della TextureBrush classe è un oggetto che usa un'immagine Brush per riempire l'interno di una forma. La classe non può essere ereditata.
ToolboxBitmapAttribute	Consente di specificare un'icona per rappresentare un controllo in un contenitore, ad esempio Microsoft Visual Studio Progettazione moduli.

Struct

Nome	Descrizione
CharacterRange	Specifica un intervallo di posizioni di caratteri all'interno di una stringa.
Color	Rappresenta un colore ARGB (alfa, rosso, verde, blu).
Point	Rappresenta una coppia ordinata di coordinate integer x e y che definisce un punto in un piano bidimensionale.
PointF	Rappresenta una coppia ordinata di coordinate x a virgola mobile e y che definisce un punto in un piano bidimensionale.
Rectangle	Archivia un set di quattro interi che rappresentano la posizione e le dimensioni di un rettangolo.
RectangleF	Archivia un set di quattro numeri a virgola mobile che rappresentano la posizione e le dimensioni di un rettangolo. Per le funzioni di area più avanzate, usare un oggetto Region.
Size	Archivia una coppia ordinata di numeri interi, che specificano un Height e Width.
SizeF	Archivia una coppia ordinata di numeri a virgola mobile, in genere la larghezza e l'altezza di un rettangolo.

Interfacce

Nome	Descrizione
IDeviceContext	Definisce i metodi per ottenere e rilasciare un handle esistente in un contesto di dispositivo Windows.

Enumerazioni

Nome	Descrizione
ContentAlignment	Specifica l'allineamento del contenuto sulla superficie di disegno.
CopyPixelOperation	Determina il modo in cui il colore di origine in un'operazione di copia pixel viene combinato con il colore di destinazione per ottenere un colore finale.
FontStyle	Specifica le informazioni sullo stile applicate al testo.
GraphicsUnit	Specifica l'unità di misura per i dati specificati.
KnownColor	Specifica i colori di sistema noti.
RotateFlipType	Specifica la quantità di rotazione di un'immagine e l'asse utilizzato per capovolgere l'immagine.
StringAlignment	Specifica l'allineamento di una stringa di testo rispetto al relativo rettangolo di layout.
StringDigitSubstitute	L'enumerazione StringDigitSubstitute specifica come sostituire le cifre in una stringa in base alle impostazioni locali o alla lingua di un utente.
StringFormatFlags	Specifica le informazioni di visualizzazione e layout per le stringhe di testo.
StringTrimming	Specifica come tagliare caratteri da una stringa che non rientra completamente in una forma di layout.
StringUnit	Specifica le unità di misura per una stringa di testo.

Delegati

Nome	Descrizione
Graphics.DrawImageAbort	Fornisce un metodo di callback per decidere quando il metodo deve annullare prematuramente l'esecuzione e interrompere il DrawImage disegno di un'immagine.
Graphics.EnumerateMetafileProc	Fornisce un metodo di callback per il EnumerateMetafile metodo .
Image.GetThumbnailImageAbort	Fornisce un metodo di callback per determinare quando il metodo deve annullare prematuramente l'esecuzione GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr) .

Commenti

Caution

Lo System.Drawing spazio dei nomi presenta alcune limitazioni per determinati sistemi operativi e tipi di applicazione.

• In Windows, System.Drawing dipende dalla libreria nativa GDI+ fornita come parte del sistema operativo. Alcuni SKU Windows, ad esempio Windows Server Core o Windows Nano, non includono questa libreria nativa come parte del sistema operativo. Se si usa questo spazio dei nomi e non è possibile caricare la libreria, le eccezioni verranno generate in fase di esecuzione.

• Alcuni tipi nello spazio dei nomi System.Drawing si basano su GDI+, che non è supportato nei servizi Windows e nelle app ASP.NET Core e ASP.NET. Questi tipi si trovano nel pacchetto NuGet System.Drawing.Common e includono System.Drawing.Bitmap e System.Drawing.Font. Tuttavia, i tipi primitivi nello spazio dei nomi, ad esempio System.Drawing.Color, System.Drawing.SizeSystem.Drawing.Point, e System.Drawing.Rectangle, possono essere usati in qualsiasi applicazione.

• In .NET 5 e versioni precedenti, il pacchetto NuGet System.Drawing.Common funziona in Windows, Linux e macOS. Esistono tuttavia alcune differenze di piattaforma. In Linux e macOS, la funzionalità GDI+ viene implementata dalla libreria libgdiplus ). Questa libreria non è installata per impostazione predefinita nella maggior parte delle distribuzioni Linux e non supporta tutte le funzionalità di GDI+ in Windows e macOS. Ci sono anche piattaforme in cui libgdiplus non è affatto disponibile. Per usare i tipi del pacchetto System.Drawing.Common in Linux e macOS, è necessario installare libgdiplus separatamente. Per altre informazioni, vedere Installare .NET in Linux o Installare .NET in macOS.

• In .NET 6 e versioni successive, il pacchetto NuGet System.Drawing.Common è supportato solo nei sistemi operativi Windows. Per altre informazioni, vedere System.Drawing.Common supportato solo in Windows.

Se non è possibile usare System.Drawing con l'applicazione, Le alternative consigliate includono ImageSharp, SkiaSharp, Windows Imaging Components e Microsoft. Maui.Graphics.

La Graphics classe fornisce metodi per il disegno nel dispositivo di visualizzazione. Classi come Rectangle e Point incapsulano primitive GDI+. La Pen classe viene utilizzata per disegnare linee e curve, mentre le classi derivate dalla classe Brush astratta vengono utilizzate per riempire gli interni delle forme.