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 applicazioni Windows Form.
Classi
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. La 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 come viene stampato un documento, in caso di stampa da un'applicazione Windows Forms. |
PrintDocument |
Definisce un oggetto riutilizzabile che invia l'output a una stampante quando si esegue la stampa da un'applicazione Windows Forms. |
PrinterResolution |
Rappresenta la risoluzione supportata da una stampante. |
PrinterSettings |
Specifica informazioni sulle modalità con cui viene stampato un documento, inclusa la stampante che lo stampa, in caso di stampa da un'applicazione Windows Forms. |
PrinterSettings.PaperSizeCollection |
Contiene una raccolta di oggetti PaperSize. |
PrinterSettings.PaperSourceCollection |
Contiene una raccolta di oggetti PaperSource. |
PrinterSettings.PrinterResolutionCollection |
Contiene una raccolta di oggetti PrinterResolution. |
PrinterSettings.StringCollection |
Contiene una raccolta di oggetti String. |
PrinterUnitConvert |
Specifica una serie di metodi di conversione utili per l'interazione con l'API di stampa Win32. La classe non può essere ereditata. |
PrintEventArgs |
Fornisce i dati per gli eventi BeginPrint e EndPrint. |
PrintingPermission |
Controlla l'accesso alle stampanti. La classe non può essere ereditata. |
PrintingPermissionAttribute |
Consente i controlli delle autorizzazioni di stampa dichiarative. |
PrintPageEventArgs |
Fornisce dati per l'evento PrintPage. |
QueryPageSettingsEventArgs |
Fornisce dati per l'evento QueryPageSettings. |
StandardPrintController |
Specifica un controller di stampa che invia informazioni alla stampante. |
Enumerazioni
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. |
Delegati
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 Forms, 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.
Nota
I DrawText metodi della classe non sono supportati per la TextRenderer stampa. Usare invece i DrawString metodi della Graphics classe .
Quando implementato in una classe derivata, controlla la PrintController modalità di stampa di un oggetto PrintDocument . Il PrintDocument.Print metodo richiama i metodi , OnEndPrintOnStartPage, e OnEndPage del controller di OnStartPrintstampa, che a sua 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 specializzato, una finestra di dialogo e un controllo. 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 ASP.NET'applicazione o servizio. 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 di runtime.
Per stampare da un'applicazione Windows Presentation Foundation (WPF), vedere lo System.Printing spazio dei nomi .