如何使用 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 系统中可用。