Spazio dei nomi System.Drawing.Printing

Lo spazio dei nomi System.Drawing.Printing fornisce servizi correlati alla stampa.

In genere, si crea una nuova istanza della classe PrintDocument, si impostano le proprietà che descrivono cosa stampare e si chiama il metodo Print per stampare effettivamente il documento.

Utilizzare la proprietà Graphics per specificare l'output di stampa. Se si stampa un file di testo, utilizzare StreamReader nel modo seguente: leggere una riga alla volta dal flusso e chiamare il metodo DrawString per tracciare la linea all’interno dell’immagine. Per ulteriori informazioni sul processo, vedere le classi Graphics e StreamReader.

Nota
La stampa non è supportata per i metodi DrawText della classe TextRenderer. Utilizzare invece i metodi DrawString della classe Graphics.

Quando è implementato in una classe derivata, l'oggetto PrintController controlla le modalità di stampa di un oggetto PrintDocument. Il metodo PrintDocument.Print richiama i metodi OnStartPrint, OnEndPrint, OnStartPage e OnEndPage del controller di stampa, che a sua volta indica alla stampante le modalità con le quali stampare il documento. Per ulteriori informazioni sulle finestre di dialogo di stampa, vedere PrintDialog e PageSetupDialog.

Per l'anteprima di stampa vengono utilizzati un controller di stampa, una finestra di dialogo e un controllo specializzati. Per un esempio di questo tipo di controller e di finestra di dialogo di stampa, vedere PreviewPrintController, PrintPreviewDialog e PrintPreviewControl.

Attenzione
Le classi incluse nello spazio dei nomi System.Drawing.Printing non sono supportate all'interno di un servizio Windows o di un servizio o un'applicazione ASP.NET. Un eventuale tentativo di utilizzare queste classi dall'interno di uno di questi tipi di applicazioni può generare problemi imprevisti, quali un degrado delle prestazioni del servizio o eccezioni in fase di esecuzione.

Classi

---

	Classe	Descrizione
	InvalidPrinterException	Rappresenta l'eccezione generata quando si tenta di accedere a una stampante mediante impostazioni non valide.
	Margins	Specifica le dimensioni dei margini di una pagina stampata.
	MarginsConverter	Fornisce un MarginsConverter per Margins.
	PageSettings	Specifica impostazioni che si applicano a una singola pagina stampata.
	PaperSize	Specifica le dimensioni del formato della carta.
	PaperSource	Specifica il cassetto dal quale la stampante riceve la carta.
	PreviewPageInfo	Specifica le informazioni dell'anteprima di stampa per una singola pagina. Questa classe non può essere ereditata.
	PreviewPrintController	Specifica un controller di stampa che visualizza un documento sullo schermo sotto forma di una serie di immagini.
	PrintController	Controlla la modalità di stampa di un documento.
	PrintDocument	Definisce un oggetto riutilizzabile che invia un output a una stampante.
	PrinterResolution	Rappresenta la risoluzione supportata da una stampante.
	PrinterSettings	Specifica informazioni sulla modalità di stampa di un documento, compresa la stampante da utilizzare.
	PrinterSettings.PaperSizeCollection	Contiene un insieme di oggetti PaperSize.
	PrinterSettings.PaperSourceCollection	Contiene un insieme di oggetti PaperSource.
	PrinterSettings.PrinterResolutionCollection	Contiene un insieme di oggetti PrinterResolution.
	PrinterSettings.StringCollection	Contiene un insieme di oggetti String.
	PrinterUnitConvert	Specifica una serie di metodi di conversione utili per l'interazione con l'API di stampa Win32. Questa classe non può essere ereditata.
	PrintEventArgs	Fornisce i dati per gli eventi BeginPrint e EndPrint.
	PrintingPermission	Controlla l'accesso alle stampanti. Questa classe non può essere ereditata.
	PrintingPermissionAttribute	Consente i controlli delle autorizzazioni di stampa dichiarative.
	PrintPageEventArgs	Fornisce i dati per l'evento PrintPage.
	QueryPageSettingsEventArgs	Fornisce i dati per l'evento QueryPageSettings.
	StandardPrintController	Specifica un controller di stampa che invia informazioni alla stampante.

Delegati

---

	Delegato	Descrizione
	PrintEventHandler	Rappresenta il metodo che gestirà l'evento BeginPrint o EndPrint di un oggetto PrintDocument.
	PrintPageEventHandler	Rappresenta il metodo che gestirà l'evento PrintPage di un oggetto PrintDocument.
	QueryPageSettingsEventHandler	Rappresenta il metodo di gestione dell'evento QueryPageSettings di un oggetto PrintDocument.

Enumerazioni

---

	Enumerazione	Descrizione
	Duplex	Specifica le impostazioni fronte retro della stampante
	PaperKind	Specifica il formato standard della carta.
	PaperSourceKind	Alimentazione standard.
	PrintAction	Specifica il tipo di operazione di stampa in corso.
	PrinterResolutionKind	Specifica una risoluzione di stampa.
	PrinterUnit	Specifica diverse unità di misura utilizzate per la stampa.
	PrintingPermissionLevel	Specifica il tipo di stampa consentito al codice.
	PrintRange	Specifica la parte del documento da stampare.