System.Drawing Spazio dei nomi

Riferimento

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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.

Condividi tramite