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

為什麼我需要設定列印設定？

列印設定是指決定如何列印文件或內容的配置或參數集。 這些設定包括紙張大小、方向(直印或橫印)、列印解析度(每英吋點數 - DPI)、列印份數、印表機選擇、邊界以及灰階列印等選項等細節。 自訂這些設定，以達到特定的列印偏好與要求。

IronPrint 全面的列印設定功能可讓開發人員精細控制列印流程的每個面向。 無論是建立桌面應用程式或 ASP.NET Web 應用程式，適當的配置都能確保在不同環境下得到一致的結果。

何時應該使用自訂列印設定？

當需要精確控制列印輸出時，自訂列印設定是不可或缺的，例如列印具有特定邊距的報告、產生多份文件，或確保文件以正確方向列印以符合業務需求。

以下是列印有特定要求的發票的實用範例：

// Example: Printing invoices with business requirements
using IronPrint;

// Invoice printing with specific business settings
var invoiceSettings = new PrintSettings
{
    PaperSize = PaperSize.Letter,        // US Letter size for business documents
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 600,                           // High quality for professional output
    NumberOfCopies = 3,                  // Original + customer copy + file copy
    PaperMargins = new Margins(15, 15, 15, 25), // Extra bottom margin for footer
    Grayscale = false,                   // Keep company logo in color
    PrinterName = "Office Color Printer" // Specific high-quality printer
};

// Print the invoice
Printer.Print("invoice_2024_001.pdf", invoiceSettings);

// Example: Printing invoices with business requirements
using IronPrint;

// Invoice printing with specific business settings
var invoiceSettings = new PrintSettings
{
    PaperSize = PaperSize.Letter,        // US Letter size for business documents
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 600,                           // High quality for professional output
    NumberOfCopies = 3,                  // Original + customer copy + file copy
    PaperMargins = new Margins(15, 15, 15, 25), // Extra bottom margin for footer
    Grayscale = false,                   // Keep company logo in color
    PrinterName = "Office Color Printer" // Specific high-quality printer
};

// Print the invoice
Printer.Print("invoice_2024_001.pdf", invoiceSettings);

如果我沒有指定列印設定會如何？

如果沒有指定列印設定，IronPrint 會使用系統預設印表機的預設設定，這可能與您的預期輸出格式或品質要求不符。 若要發現系統上可用的印表機，請使用 GetPrinterNames 方法 以程式化的方式擷取所有連接的印表機。

哪些列印設定應該經常設定？

對於大多數商業應用程式，請務必設定 PaperOrientation 及 Dpi，以確保在不同印表機和系統間輸出結果一致。 這三種設定對文件的外觀和可讀性影響最大。

在使用基於對話方塊的列印時，請使用 ShowPrintDialog 方法，將自訂設定與使用者互動結合：

// Pre-configure settings but allow user to modify
var presetSettings = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300
};

// Show dialog with preset values
Printer.ShowPrintDialog("report.pdf", presetSettings);

// Pre-configure settings but allow user to modify
var presetSettings = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300
};

// Show dialog with preset values
Printer.ShowPrintDialog("report.pdf", presetSettings);

如何處理特定平台的設定？

某些設定(如托盤選擇)僅在 Windows 上可用。 使用特定平台功能時，務必檢查平台相容性，並為跨平台應用程式提供備用行為。 有關特定平台問題的疑難排解，請參閱 工程支援指南。

常見的列印設定組合有哪些？

常見的組合包括用於標準文件的 A4/Portrait/300 DPI、用於詳細報告的 A3/Landscape/600 DPI，以及用於草稿列印以節省油墨的 Letter/Portrait/300 DPI/Grayscale。

以下是一個展示不同情境的範例：

// Standard office document
var standardDocument = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300
};

// Detailed engineering drawing
var technicalDrawing = new PrintSettings
{
    PaperSize = PaperSize.A3,
    PaperOrientation = PaperOrientation.Landscape,
    Dpi = 600,
    Grayscale = false
};

// Draft mode for review
var draftMode = new PrintSettings
{
    PaperSize = PaperSize.Letter,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 150,
    Grayscale = true,
    NumberOfCopies = 5
};

// High-volume batch printing
var batchPrint = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300,
    NumberOfCopies = 100,
    Tray = "Tray 2" // Large capacity tray on Windows
};

// Standard office document
var standardDocument = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300
};

// Detailed engineering drawing
var technicalDrawing = new PrintSettings
{
    PaperSize = PaperSize.A3,
    PaperOrientation = PaperOrientation.Landscape,
    Dpi = 600,
    Grayscale = false
};

// Draft mode for review
var draftMode = new PrintSettings
{
    PaperSize = PaperSize.Letter,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 150,
    Grayscale = true,
    NumberOfCopies = 5
};

// High-volume batch printing
var batchPrint = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300,
    NumberOfCopies = 100,
    Tray = "Tray 2" // Large capacity tray on Windows
};

如需更全面的範例和進階列印情境，請探索 列印文件教學，其中涵蓋從頭到尾的完整列印工作流程。

在生產環境中實施列印設定時，尤其是在使用 Web.config 的 Web 應用程式中，請檢閱 在 Web.config 中設定授權金鑰的指南，以確保配置正確。