System.Drawing.Printing 命名空間

為 Windows Forms 應用程式提供列印相關的服務。

類別

InvalidPrinterException	表示在嘗試使用無效的印表機設定來存取印表機時擲回的例外狀況。
Margins	指定列印的頁面之邊界的維度。
MarginsConverter	為 MarginsConverter 提供 Margins。
PageSettings	指定要套用到單一列印頁面的設定。
PaperSize	指定紙張的大小。
PaperSource	指定印表機取得紙張的紙匣。
PreviewPageInfo	指定單一頁面的預覽列印資訊。 此類別無法獲得繼承。
PreviewPrintController	指定可在螢幕上將文件以連續影像顯示的列印控制程式。
PrintController	控制從 Windows Form 應用程式列印時，將要如何列印文件。
PrintDocument	定義從 Windows Forms 應用程式中列印時會將輸出傳送至印表機的可重複使用物件。
PrinterResolution	表示印表機所支援的解析度。
PrinterSettings	指定從 Windows Form 應用程式列印時，文件如何列印的相關資訊，包括用來列印的印表機。
PrinterSettings.PaperSizeCollection	包含 PaperSize 物件的集合。
PrinterSettings.PaperSourceCollection	包含 PaperSource 物件的集合。
PrinterSettings.PrinterResolutionCollection	包含 PrinterResolution 物件的集合。
PrinterSettings.StringCollection	包含 String 物件的集合。
PrinterUnitConvert	指定一系列與 Win32 列印 API 互通時適用的轉換方法。 此類別無法獲得繼承。
PrintEventArgs	提供 BeginPrint 和 EndPrint 事件的資料。
PrintingPermission	控制印表機的存取。 此類別無法獲得繼承。
PrintingPermissionAttribute	允許宣告式列印使用權限檢查。
PrintPageEventArgs	提供 PrintPage 事件的資料。
QueryPageSettingsEventArgs	提供 QueryPageSettings 事件的資料。
StandardPrintController	指定傳送訊息至印表機的列印控制程式。

列舉

Duplex	指定印表機的雙面列印設定。
PaperKind	指定標準紙張大小。
PaperSourceKind	標準紙張來源。
PrintAction	指定執行之列印作業的類型。
PrinterResolutionKind	指定印表機解析度。
PrinterUnit	指定用於列印的數種度量單位。
PrintingPermissionLevel	指定程式碼允許進行的列印類型。
PrintRange	指定文件中要列印的部分。

委派

PrintEventHandler	表示處理 BeginPrint 的 EndPrint 或 PrintDocument 事件的方法。
PrintPageEventHandler	代表將處理 PrintPage 之 PrintDocument 事件的方法。
QueryPageSettingsEventHandler	代表處理 PrintDocument 之 QueryPageSettings 事件的方法。

備註

一般而言，當您從Windows Forms應用程式列印時，您會建立 類別的新實例 PrintDocument 、設定 屬性，例如 DefaultPageSettings 和 PrinterSettings ，描述如何列印，並呼叫 Print 方法以實際列印檔案。 PrintDocument.Print呼叫 方法會 PrintDocument.PrintPage 引發 事件，這個事件應該處理以執行列印的檔版面配置。

Graphics使用從 PrintDocument.PrintPage 事件取得之 物件的 屬性 PrintPageEventArgs ，指定要列印的輸出。 如果您要列印文字檔，請使用 StreamReader 從資料流程一次讀取一行，並呼叫 DrawString 方法在繪圖物件中繪製線條。 如需此程式的詳細資訊，請參閱 Graphics 和 StreamReader 類別。 您可以在類別概觀主題中 PrintDocument 檢視列印文字檔的範例。

注意

DrawText列印不支援 類別的方法 TextRenderer 。 請改用 DrawString 類別的方法 Graphics 。

在衍生類別中實作時，會 PrintController 控制 如何 PrintDocument 列印 。 方法 PrintDocument.Print 會叫用列印控制器的 OnStartPrint 、 OnEndPrint 、 OnStartPage 和 OnEndPage 方法，然後告訴印表機如何列印檔案。 如需列印對話方塊的詳細資訊，請參閱 PrintDialog 和 PageSetupDialog 。

預覽列印程式會使用特殊的列印控制器、對話方塊和控制項。 如需這類列印控制器和對話方塊的範例，請參閱 PreviewPrintController 、 PrintPreviewDialog 和 PrintPreviewControl 。

警告

不支援命名空間內的 System.Drawing.Printing 類別用於 Windows 服務或 ASP.NET 應用程式或服務。 嘗試從其中一個應用程式類型內使用這些類別可能會產生非預期的問題，例如服務效能降低和執行時間例外狀況。

如果您想要從Windows Presentation Foundation (WPF) 應用程式列印，請參閱 System.Printing 命名空間。

另請參閱

• PrintDialog
• Windows Form 列印支援