System.Drawing.Printing Spazio dei nomi

Lo spazio dei nomi System.Drawing.Printing fornisce servizi correlati alla stampa per applicazioni Windows Form. The System.Drawing.Printing namespace provides print-related services for Windows Forms applications.

Classi

InvalidPrinterException

Rappresenta l'eccezione generata quando si tenta di accedere a una stampante mediante impostazioni non valide.Represents the exception that is thrown when you try to access a printer using printer settings that are not valid.

Margins

Specifica le dimensioni dei margini di una pagina stampata.Specifies the dimensions of the margins of a printed page.

MarginsConverter

Fornisce un MarginsConverter per Margins.Provides a MarginsConverter for Margins.

PageSettings

Specifica impostazioni che si applicano a una singola pagina stampata.Specifies settings that apply to a single, printed page.

PaperSize

Specifica le dimensioni del formato della carta.Specifies the size of a piece of paper.

PaperSource

Specifica il cassetto dal quale la stampante riceve la carta.Specifies the paper tray from which the printer gets paper.

PreviewPageInfo

Specifica le informazioni dell'anteprima di stampa per una singola pagina.Specifies print preview information for a single page. Questa classe non può essere ereditata.This class cannot be inherited.

PreviewPrintController

Specifica un controller di stampa che visualizza un documento sullo schermo sotto forma di una serie di immagini.Specifies a print controller that displays a document on a screen as a series of images.

PrintController

Controlla come viene stampato un documento, in caso di stampa da un'applicazione Windows Forms.Controls how a document is printed, when printing from a Windows Forms application.

PrintDocument

Definisce un oggetto riutilizzabile che invia l'output a una stampante quando si esegue la stampa da un'applicazione Windows Forms.Defines a reusable object that sends output to a printer, when printing from a Windows Forms application.

PrinterResolution

Rappresenta la risoluzione supportata da una stampante.Represents the resolution supported by a printer.

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.Specifies information about how a document is printed, including the printer that prints it, when printing from a Windows Forms application.

PrinterSettings.PaperSizeCollection

Contiene una raccolta di oggetti PaperSize.Contains a collection of PaperSize objects.

PrinterSettings.PaperSourceCollection

Contiene una raccolta di oggetti PaperSource.Contains a collection of PaperSource objects.

PrinterSettings.PrinterResolutionCollection

Contiene una raccolta di oggetti PrinterResolution.Contains a collection of PrinterResolution objects.

PrinterSettings.StringCollection

Contiene una raccolta di oggetti String.Contains a collection of String objects.

PrinterUnitConvert

Specifica una serie di metodi di conversione utili per l'interazione con l'API di stampa Win32.Specifies a series of conversion methods that are useful when interoperating with the Win32 printing API. Questa classe non può essere ereditata.This class cannot be inherited.

PrintEventArgs

Fornisce i dati per gli eventi BeginPrint e EndPrint.Provides data for the BeginPrint and EndPrint events.

PrintingPermission

Controlla l'accesso alle stampanti.Controls access to printers. Questa classe non può essere ereditata.This class cannot be inherited.

PrintingPermissionAttribute

Consente i controlli delle autorizzazioni di stampa dichiarative.Allows declarative printing permission checks.

PrintPageEventArgs

Fornisce dati per l'evento PrintPage.Provides data for the PrintPage event.

QueryPageSettingsEventArgs

Fornisce dati per l'evento QueryPageSettings.Provides data for the QueryPageSettings event.

StandardPrintController

Specifica un controller di stampa che invia informazioni alla stampante.Specifies a print controller that sends information to a printer.

Enumerazioni

Duplex

Specifica le impostazioni fronte retro della stampanteSpecifies the printer's duplex setting.

PaperKind

Specifica il formato standard della carta.Specifies the standard paper sizes.

PaperSourceKind

Alimentazione standard.Standard paper sources.

PrintAction

Specifica il tipo di operazione di stampa in corso.Specifies the type of print operation occurring.

PrinterResolutionKind

Specifica una risoluzione di stampa.Specifies a printer resolution.

PrinterUnit

Specifica diverse unità di misura utilizzate per la stampa.Specifies several of the units of measure used for printing.

PrintingPermissionLevel

Specifica il tipo di stampa consentito al codice.Specifies the type of printing that code is allowed to do.

PrintRange

Specifica la parte del documento da stampare.Specifies the part of the document to print.

Delegati

PrintEventHandler

Rappresenta il metodo che gestirà l'evento BeginPrint o EndPrint di un oggetto PrintDocument.Represents the method that will handle the BeginPrint or EndPrint event of a PrintDocument.

PrintPageEventHandler

Rappresenta il metodo che gestirà l'evento PrintPage di un oggetto PrintDocument.Represents the method that will handle the PrintPage event of a PrintDocument.

QueryPageSettingsEventHandler

Rappresenta il metodo che gestisce l'evento QueryPageSettings di un oggetto PrintDocument.Represents the method that handles the QueryPageSettings event of a PrintDocument.

Commenti

In genere, quando si stampa da un'applicazione Windows Forms, si crea una nuova istanza della PrintDocument classe, impostare le proprietà, ad esempio DefaultPageSettings e PrinterSettings, che descrivono cosa stampare e chiamare il Print metodo effettivamente stampare il documento.Typically, when you print from a Windows Forms application, you create a new instance of the PrintDocument class, set properties, such as DefaultPageSettings and PrinterSettings, that describe how to print, and call the Print method to actually print the document. Chiama il PrintDocument.Print metodo che genera il PrintDocument.PrintPage evento, che deve essere gestito per eseguire il layout del documento per la stampa.Calling the PrintDocument.Print method raises the PrintDocument.PrintPage event, which should be handled to perform the document layout for printing.

Usare il Graphics proprietà del PrintPageEventArgs ottenuto dall'oggetto di PrintDocument.PrintPage eventi per specificare l'output da stampare.Use the Graphics property of the PrintPageEventArgs object obtained from the PrintDocument.PrintPage event to specify the output to print. Se si stampa un file di testo, usare StreamReader per leggere una riga alla volta dal flusso e chiamare il DrawString metodo consente di disegnare la riga nell'oggetto grafico.If you are printing a text file, use StreamReader to read one line at a time from the stream and call the DrawString method to draw the line in the graphics object. Per altre informazioni su questo processo, vedere la Graphics e StreamReader classi.For more information about this process, see the Graphics and StreamReader classes. È possibile visualizzare un esempio di stampa di un documento di testo nel PrintDocument Cenni preliminari sulla classe.You can view an example of printing a text document in the PrintDocument class overview topic.

Nota

Il DrawText metodi del TextRenderer classe non sono supportati per la stampa.The DrawText methods of the TextRenderer class are not supported for printing. Usare invece i DrawString metodi del Graphics classe.Instead, use the DrawString methods of the Graphics class.

Una volta implementato in una classe derivata, il PrintController controlli come un PrintDocument viene stampato.When implemented in a derived class, the PrintController controls how a PrintDocument is printed. Il PrintDocument.Print metodo richiama il controller di stampa OnStartPrint, OnEndPrint, OnStartPage, e OnEndPage metodi, che a sua volta indicano la stampante come stampare il documento.The PrintDocument.Print method invokes the print controller's OnStartPrint, OnEndPrint, OnStartPage, and OnEndPage methods, which in turn tell the printer how to print the document. Per altre informazioni sulle finestre di dialogo di stampa, vedere PrintDialog e PageSetupDialog.For more information about printing dialog boxes, see PrintDialog and PageSetupDialog.

Il processo di anteprima di stampa Usa un controller di stampa specializzate, finestra di dialogo e controllo.The print-preview process uses a specialized print controller, dialog box, and control. Per un esempio di questo controller di stampa e la finestra di dialogo, vedere PreviewPrintController, PrintPreviewDialog, e PrintPreviewControl.For an example of such a print controller and dialog box, see PreviewPrintController, PrintPreviewDialog, and PrintPreviewControl.

Attenzione

Le classi all'interno di System.Drawing.Printing dello spazio dei nomi non sono supportati per l'uso all'interno di un servizio o applicazione ASP.NET o servizio di Windows.Classes within the System.Drawing.Printing namespace are not supported for use within a Windows service or ASP.NET application or service. Tentativo di utilizzare queste classi all'interno di uno di questi tipi di applicazione può generare problemi imprevisti, quali un degrado delle eccezioni di runtime e le prestazioni del servizio.Attempting to use these classes from within one of these application types may produce unexpected problems, such as diminished service performance and run-time exceptions.

Se si vuole stampare da un'applicazione Windows Presentation Foundation (WPF), vedere il System.Printing dello spazio dei nomi.If you want to print from a Windows Presentation Foundation (WPF) application, see the System.Printing namespace.

Vedi anche