如何使用 IronPrint 在 C# 中配置列印設定

設定列印設定

若要配置列印設置，請實例化 PrintSettings 類別並根據您的喜好進行配置。 在Print或ShowPrintDialog方法中，將 PrintSettings 物件作為第二個參數傳遞。 下面的程式碼範例說明了這種用法。

// Import the necessary namespace for IronPrint
using IronPrint;

// Initialize a new instance of the PrintSettings class
PrintSettings settings = new PrintSettings();

// Configure various print settings
settings.PaperSize = PaperSize.A4;                // Set paper size to A4
settings.PaperOrientation = PaperOrientation.Landscape; // Set paper orientation to Landscape
settings.Dpi = 300;                               // Set print resolution to 300 DPI
settings.NumberOfCopies = 2;                      // Set the number of copies to 2
settings.PrinterName = "MyPrinter";               // Set the name of the printer
settings.PaperMargins = new Margins(10, 10, 10, 10); // Set margins to 10mm on each side
settings.Grayscale = true;                        // Print in grayscale

// Use the PrintSettings in the Print method
IronPrint.Printer.Print(document, settings);

// Import the necessary namespace for IronPrint
using IronPrint;

// Initialize a new instance of the PrintSettings class
PrintSettings settings = new PrintSettings();

// Configure various print settings
settings.PaperSize = PaperSize.A4;                // Set paper size to A4
settings.PaperOrientation = PaperOrientation.Landscape; // Set paper orientation to Landscape
settings.Dpi = 300;                               // Set print resolution to 300 DPI
settings.NumberOfCopies = 2;                      // Set the number of copies to 2
settings.PrinterName = "MyPrinter";               // Set the name of the printer
settings.PaperMargins = new Margins(10, 10, 10, 10); // Set margins to 10mm on each side
settings.Grayscale = true;                        // Print in grayscale

// Use the PrintSettings in the Print method
IronPrint.Printer.Print(document, settings);

' Import the necessary namespace for IronPrint
Imports IronPrint

' Initialize a new instance of the PrintSettings class
Private settings As New PrintSettings()

' Configure various print settings
settings.PaperSize = PaperSize.A4 ' Set paper size to A4
settings.PaperOrientation = PaperOrientation.Landscape ' Set paper orientation to Landscape
settings.Dpi = 300 ' Set print resolution to 300 DPI
settings.NumberOfCopies = 2 ' Set the number of copies to 2
settings.PrinterName = "MyPrinter" ' Set the name of the printer
settings.PaperMargins = New Margins(10, 10, 10, 10) ' Set margins to 10mm on each side
settings.Grayscale = True ' Print in grayscale

' Use the PrintSettings in the Print method
IronPrint.Printer.Print(document, settings)

可用的列印設定

請查看以下所有可用的列印設定選項：

• DefaultSettings ：使用預設值初始化 IronPrint.PrintSettings 類別的新實例。
• PaperSize ：設定印表機使用的紙張尺寸。 預設值為 IronPrint.PaperSize.PrinterDefault。
• PaperOrientation ：指定紙張方向（例如，縱向或橫向）。 預設值為 IronPrint.PaperOrientation.Portrait。
• Dpi ：表示預期的列印分辨率，單位為每英吋點數。 預設值為 300，這是商業印刷中常用的設定。 備註：實際列印所用的DPI可能受限於印表機的效能。
• NumberOfCopies ：指示列印文件時要產生的相同副本的數量。 預設值為 1 份。 備註：在某些平台上，可能會有一些限制，導致無法準確複製多個副本。 在這種情況下，IronPrint.PrintSettings.NumberOfCopies 的指定值可能會被忽略，導致只列印一份副本。
• PrinterName ：指定用於列印的印表機的名稱。 預設值為空，這表示將使用作業系統目前的預設印表機。 備註：如果在列印對話方塊中選擇印表機，則此設定將被忽略。 若要取得可用的印表機名稱，可以使用 IronPrint.Printer.GetPrinterNames 或 IronPrint.Printer.GetPrinterNamesAsync 來取得印表機名稱清單。
• PaperMargins ：設定列印時使用的頁邊距（單位：毫米）。 預設值為空，表示使用印表機提供的預設邊距。 -灰階：指示是否以灰階列印。 備註：預設值為 false，表示嘗試彩色列印。 -展平：在列印前展平 PDF，這對於顯示表單欄位值和影像非常有用。 預設值為 false，表示 PDF 在列印前將被展平。 -紙匣：用於列印作業的印表機紙匣。 這樣，使用者可以指定要從哪個紙匣向印表機送紙。 如果在列印對話方塊中選擇紙盒，則此設定將被忽略。 若要取得可用紙盒，可以使用 IronPrint.Printer.GetPrinterTrays(System.String) 或 IronPrint.Printer.GetPrinterTraysAsync(System.String)。 預設值為空，表示使用印表機提供的預設紙匣。 此托盤選擇屬性僅在 Windows 系統中可用。