System.Drawing Spazio dei nomi

Fornisce accesso alle funzionalità grafiche di base di 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

Bitmap

Incapsula una bitmap GDI+ costituita dai dati pixel di un'immagine e dai relativi attributi. Bitmap è un oggetto utilizzato per operare con immagini definite dai dati pixel.

BitmapSuffixInSameAssemblyAttribute

Specifica che, durante l'interpretazione delle dichiarazioni di ToolboxBitmapAttribute, le risorse indicate devono essere cercate dall'assembly nello stesso assembly, ma con il valore di configurazione di BitmapSuffix aggiunto al nome file dichiarato.

BitmapSuffixInSatelliteAssemblyAttribute

Specifica che, durante l'interpretazione delle dichiarazioni di ToolboxBitmapAttribute, le risorse indicate devono essere cercate dall'assembly in un assembly satellite, ma con il valore di configurazione di BitmapSuffix aggiunto al nome file dichiarato.

Brush

Consente di definire gli oggetti utilizzati per riempire le parti interne di forme grafiche quali rettangoli, ellissi, torte, poligoni e tracciati.

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 utilizzati per il doppio buffer.

BufferedGraphicsManager

Fornisce accesso all'oggetto di contesto grafico principale memorizzato nella cache per il dominio applicazione.

ColorConverter

Converte i colori da un tipo di dati all'altro. È possibile accedere a questa classe mediante l'oggetto TypeDescriptor.

ColorTranslator

Converte colori da e verso strutture Color GDI+. La classe non può essere ereditata.

Font

Definisce un particolare formato per il testo, compresi tipo di carattere, dimensioni e attributi di stile. La classe non può essere ereditata.

FontConverter

Converte gli oggetti Font da un tipo di dati all'altro.

FontConverter.FontNameConverter

FontConverter.FontNameConverter è un tipo di convertitore utilizzato per le conversioni tra il nome di un tipo di carattere e altre rappresentazioni.

FontConverter.FontUnitConverter

Converte le unità del tipo di carattere in e da altri tipi di unità.

FontFamily

Definisce un gruppo di tipi di carattere che presentano una progettazione 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 di Windows, ossia una piccola immagine bitmap usata per rappresentare un oggetto. Le icone possono essere considerate come delle bitmap trasparenti, anche se le loro dimensioni sono determinate dal sistema.

IconConverter

Converte un oggetto Icon da un tipo di dati all'altro. È possibile accedere a questa classe mediante l'oggetto TypeDescriptor.

Image

Classe base astratta che fornisce funzionalità per le classi derivate Bitmap e Metafile.

ImageAnimator

Anima un'immagine con fotogrammi in successione temporale.

ImageConverter

ImageConverter è una classe che può essere utilizzata per convertire gli oggetti Image da un tipo di dati a all'altro. È possibile accedere a questa classe mediante l'oggetto TypeDescriptor.

ImageFormatConverter

ImageFormatConverter è una classe che può essere utilizzata per convertire gli oggetti ImageFormat da un tipo di dati a all'altro. È possibile accedere a questa classe mediante l'oggetto TypeDescriptor.

Pen

Definisce un oggetto usato 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 all'altro.

RectangleConverter

Converte i rettangoli da un tipo di dati all'altro. È possibile accedere a questa classe mediante l'oggetto TypeDescriptor.

Region

Descrive la parte interna di una forma grafica composta da rettangoli e tracciati. La classe non può essere ereditata.

SizeConverter

La classe SizeConverter viene utilizzata per eseguire conversioni da un tipo di dati all'altro. È possibile accedere a questa classe mediante l'oggetto TypeDescriptor.

SizeFConverter

Converte gli oggetti SizeF da un tipo all'altro.

SolidBrush

Definisce un pennello di colore singolo. I pennelli vengono utilizzati per riempire le forme grafiche, come rettangoli, ellissi, torte, poligoni e tracciati. La classe non può essere ereditata.

StringFormat

Incapsula le informazioni di layout del testo (come l'allineamento, l'orientamento e i punti di tabulazione), le operazioni di modifica della visualizzazione (come l'inserimento dei puntini di sospensione e la sostituzione di numeri nazionali) e le funzionalità OpenType. La classe non può essere ereditata.

SystemBrushes

Ciascuna proprietà della classe SystemBrushes è un oggettoSolidBrush che corrisponde al colore di un elemento di visualizzazione di Windows.

SystemColors

Ciascuna proprietà della classe SystemColors è una struttura Color che corrisponde al colore di un elemento di visualizzazione di Windows.

SystemFonts

Specifica il tipo di carattere utilizzato per visualizzare il testo negli elementi di visualizzazione di Windows.

SystemIcons

Ciascuna proprietà della classe SystemIcons corrisponde a un oggetto Icon per le icone di sistema Windows. La classe non può essere ereditata.

SystemPens

Ciascuna proprietà della classe SystemPens è un oggetto Pen che corrisponde al colore di un elemento di visualizzazione di Windows e a una larghezza pari a 1 pixel.

TextureBrush

Ciascuna proprietà della classe TextureBrush rappresenta un oggetto Brush che utilizza un'immagine per riempire la parte interna di una forma. La classe non può essere ereditata.

ToolboxBitmapAttribute

Consente di specificare un'icona per rappresentare un controllo in un contenitore, quale Progettazione form di Microsoft Visual Studio.

Struct

CharacterRange

Specifica un intervallo di posizioni di caratteri all'interno di una stringa.

Color

Rappresenta un colore ARGB (alfa, rosso, verde, blu).

Point

Consente di rappresentare una coppia ordinata di coordinate di valori interi x- e y per definire un punto in un piano a due dimensioni.

PointF

Rappresenta una coppia ordinata di coordinate x e y a virgola mobile, 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

Memorizza un set di quattro numeri a vergola mobile che rappresentano la posizione e le dimensioni del rettangolo. Per informazioni sulle funzioni di area avanzate, utilizzare un oggetto Region.

Size

Archivia una coppia ordinata di Integer che specificano Height e Width.

SizeF

Archivia una coppia ordinata di numeri a virgola mobile, generalmente la larghezza e l'altezza di un rettangolo.

Interfacce

IDeviceContext

Definisce i metodi per ottenere e rilasciare un handle esistente per un contesto di periferica Windows.

Enumerazioni

ContentAlignment

Specifica l'allineamento del contenuto sulla superficie di disegno.

CopyPixelOperation

Determina la modalità di combinazione del colore di origine in un'operazione di copia di pixel con il colore di destinazione in modo da ottenere il colore finale.

FontStyle

Specifica le informazioni di stile applicate al testo.

GraphicsUnit

Specifica l'unità di misura dei dati indicati.

KnownColor

Specifica i colori di sistema noti.

RotateFlipType

Specifica l'ampiezza di rotazione di un'immagine e l'asse utilizzato per capovolgere l'immagine.

StockIconId

Fornisce gli identificatori di icona da usare con GetStockIcon(StockIconId, StockIconOptions).

StockIconOptions

Fornisce opzioni per l'uso con GetStockIcon(StockIconId, StockIconOptions).

StringAlignment

Specifica l'allineamento di una stringa di testo in relazione al suo rettangolo di layout.

StringDigitSubstitute

L'enumerazione StringDigitSubstitute specifica come sostituire i numeri di una stringa in relazione alla lingua o alle impostazioni locali di un utente.

StringFormatFlags

Specifica le informazioni relative alla visualizzazione e al layout per le stringhe di testo.

StringTrimming

Specifica come eliminare i caratteri di una stringa che non rientrano interamente in una forma di layout.

StringUnit

Specifica le unità di misura per una stringa di testo.

Delegati

Graphics.DrawImageAbort

Fornisce un metodo di callback per decidere quando il metodo DrawImage deve annullare l'esecuzione e interrompere il disegno di un'immagine.

Graphics.EnumerateMetafileProc

Fornisce un metodo di callback per il metodo EnumerateMetafile.

Image.GetThumbnailImageAbort

Fornisce un metodo di callback per determinare quando il metodo GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr) deve annullare l'esecuzione in modo anomalo.

Commenti

Attenzione

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+, che viene fornita come parte del sistema operativo. Alcuni SKU di 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 la libreria non può essere caricata, le eccezioni verranno generate in fase di esecuzione.

  • Alcuni tipi nello spazio dei System.Drawing nomi 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.Size, System.Drawing.Pointe 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. Esistono anche piattaforme in cui libgdiplus non è disponibile. Per usare i tipi dal 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 incapsulate primitive GDI+. La Pen classe viene usata per disegnare linee e curve, mentre le classi derivate dalla classe Brush astratta vengono usate per riempire gli interni delle forme.