System.Drawing.Printing Spazio dei nomi
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 servizi correlati alla stampa per le applicazioni Windows Form.
Classi
| Nome | Descrizione |
|---|---|
| InvalidPrinterException |
Rappresenta l'eccezione generata quando si tenta di accedere a una stampante utilizzando le impostazioni della stampante non valide. |
| Margins |
Specifica le dimensioni dei margini di una pagina stampata. |
| MarginsConverter |
Fornisce un oggetto MarginsConverter per Margins. |
| PageSettings |
Specifica le impostazioni che si applicano a una singola pagina stampata. |
| PaperSize |
Specifica le dimensioni di un pezzo di carta. |
| PaperSource |
Specifica il vassoio di carta da cui la stampante ottiene carta. |
| PreviewPageInfo |
Specifica le informazioni di anteprima di stampa per una singola pagina. Questa classe non può essere ereditata. |
| PreviewPrintController |
Specifica un controller di stampa che visualizza un documento su uno schermo come una serie di immagini. |
| PrintController |
Controlla la modalità di stampa di un documento durante la stampa da un'applicazione Windows Form. |
| PrintDocument |
Definisce un oggetto riutilizzabile che invia l'output a una stampante durante la stampa da un'applicazione Windows Form. |
| PrinterResolution |
Rappresenta la risoluzione supportata da una stampante. |
| PrinterSettings |
Specifica le informazioni sulla stampa di un documento, inclusa la stampante che la stampa, durante la stampa da un'applicazione Windows Form. |
| PrinterSettings.PaperSizeCollection |
Contiene una raccolta di PaperSize oggetti . |
| PrinterSettings.PaperSourceCollection |
Contiene una raccolta di PaperSource oggetti . |
| PrinterSettings.PrinterResolutionCollection |
Contiene una raccolta di PrinterResolution oggetti . |
| PrinterSettings.StringCollection |
Contiene una raccolta di String oggetti . |
| PrinterUnitConvert |
Specifica una serie di metodi di conversione utili per l'interoperabilità con l'API di stampa Win32. Questa classe non può essere ereditata. |
| PrintEventArgs |
Fornisce dati per gli eventi BeginPrint e EndPrint. |
| PrintingPermission |
Controlla l'accesso alle stampanti. Questa classe non può essere ereditata. |
| PrintingPermissionAttribute |
Consente controlli di autorizzazione di stampa dichiarativa. |
| 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 a una stampante. |
Enumerazioni
| Nome | Descrizione |
|---|---|
| Duplex |
Specifica l'impostazione duplex della stampante. |
| PaperKind |
Specifica le dimensioni standard della carta. |
| PaperSourceKind |
Fonti di carta standard. |
| PrintAction |
Specifica il tipo di operazione di stampa in corso. |
| PrinterResolutionKind |
Specifica una risoluzione della stampante. |
| PrinterUnit |
Specifica diverse unità di misura utilizzate per la stampa. |
| PrintingPermissionLevel |
Specifica il tipo di stampa consentito dal codice. |
| PrintRange |
Specifica la parte del documento da stampare. |
Delegati
| Nome | 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 che gestisce l'evento QueryPageSettings di un oggetto PrintDocument. |
Commenti
In genere, quando si stampa da un'applicazione Windows Form, si crea una nuova istanza della PrintDocument classe , si impostano proprietà, ad esempio DefaultPageSettings e PrinterSettings, che descrivono come stampare e chiamare il Print metodo per stampare effettivamente il documento. La chiamata al PrintDocument.Print metodo genera l'evento PrintDocument.PrintPage , che deve essere gestito per eseguire il layout del documento per la stampa.
Utilizzare la Graphics proprietà dell'oggetto PrintPageEventArgs ottenuto dall'evento PrintDocument.PrintPage per specificare l'output da stampare. Se si stampa un file di testo, utilizzare StreamReader per leggere una riga alla volta dal flusso e chiamare il DrawString metodo per disegnare la linea nell'oggetto grafico. Per altre informazioni su questo processo, vedere le Graphics classi e StreamReader . È possibile visualizzare un esempio di stampa di un documento di testo nell'argomento di panoramica della PrintDocument classe.
Annotazioni
I DrawText metodi della classe non sono supportati per la TextRenderer stampa. Usare invece i DrawString metodi della Graphics classe .
Se implementato in una classe derivata, controlla la PrintController modalità di stampa di un oggetto PrintDocument . Il PrintDocument.Print metodo richiama i metodi , OnEndPrint, OnStartPagee OnEndPage del controller di OnStartPrintstampa, che a loro volta indicano alla stampante come stampare il documento. Per altre informazioni sulla stampa delle finestre di dialogo, vedere PrintDialog e PageSetupDialog.
Il processo di anteprima di stampa usa un controller di stampa, una finestra di dialogo e un controllo specializzati. Per un esempio di controller di stampa e finestra di dialogo, vedere PreviewPrintController, PrintPreviewDialoge PrintPreviewControl.
Attenzione
Le classi all'interno dello spazio dei System.Drawing.Printing nomi non sono supportate per l'uso all'interno di un servizio Windows o di un'applicazione o di un servizio ASP.NET. Il tentativo di usare queste classi all'interno di uno di questi tipi di applicazione può generare problemi imprevisti, ad esempio le prestazioni del servizio ridotte e le eccezioni in fase di esecuzione.
Se si vuole stampare da un'applicazione Windows Presentation Foundation (WPF), vedere lo spazio dei System.Printing nomi .
