C#で印刷する際の用紙サイズを設定する方法

C#で印刷時に用紙サイズを設定する方法

私たちはPaperSize列挙型からの値をPrintSettingsオブジェクトのPaperSizeプロパティに割り当てることで用紙サイズを設定します。 そのオブジェクトをIronPrintの印刷メソッドに渡します。

:path=/static-assets/print/content-code-examples/how-to/set-paper-size/set-paper-size-set-paper-size.cs

using IronPrint;

// Configure print settings with US Letter paper
PrintSettings settings = new PrintSettings();
settings.PaperSize = PaperSize.Letter;

// Print to the default printer
Printer.Print("invoice.pdf", settings);

Imports IronPrint

' Configure print settings with US Letter paper
Dim settings As New PrintSettings()
settings.PaperSize = PaperSize.Letter

' Print to the default printer
Printer.Print("invoice.pdf", settings)

まず、PrintSettingsをインスタンス化し、それがプリンタのデフォルトで初期化されます。 次に、PaperSize.Letterでオーバーライドし、これにより標準の8.5×11インチの形式にマップします。 私たちがPrinter.Printを呼び出すと、IronPrintはその用紙サイズを使用してドキュメントをシステムのデフォルトプリンタに送信します。

もしPaperSize.PrinterDefaultを使用し、これがオペレーティングシステムのデフォルトプリンタが使用するように設定している用紙サイズを参照します。 プリンターの設定がマシンごとに異なる生産環境では、これは重要な詳細です。

ライブラリーがサポートする用紙サイズはどれですか？

PaperSize列挙型には、ISO国際標準、一般的な米国サイズ、およびプリンタデフォルトを含む12の値が含まれています。 以下の表には利用可能なすべてのオプションが示されています。

各値は直接的に著名な用紙標準にマッピングされます。 PrinterDefaultオプションは、プリンタが現在設定されているサイズを使用するようIronPrintに指示します - エンドユーザーのプリンターの設定を尊重したい場合に便利です。

PaperSizeクラスのドキュメントで完全なAPIリファレンスを参照してください。

用紙サイズを他の印刷設定と組み合わせる方法は？

PaperSizeの他にいくつかのプロパティを公開しています。 方向、DPI、余白、コピー数、グレースケールモードを1つのオブジェクトで設定できます。

:path=/static-assets/print/content-code-examples/how-to/set-paper-size/set-paper-size-combined-settings.cs

using IronPrint;

// Configure full print settings
PrintSettings settings = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Landscape,
    Dpi = 300,
    NumberOfCopies = 3,
    PaperMargins = new Margins(15, 15, 15, 15),
    Grayscale = false
};

// Print the quarterly report
Printer.Print("quarterly-report.pdf", settings);

Imports IronPrint

' Configure full print settings
Dim settings As New PrintSettings With {
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Landscape,
    .Dpi = 300,
    .NumberOfCopies = 3,
    .PaperMargins = New Margins(15, 15, 15, 15),
    .Grayscale = False
}

' Print the quarterly report
Printer.Print("quarterly-report.pdf", settings)

明確さのために、オブジェクト初期化子構文を使用します。 OrientationはA4用紙をより広い軸に回転させます。 DPIの300で、チャートや細かいテキストのために鋭い出力を確保します。 Marginsコンストラクターを介して、ミリメートル単位で、上、右、下、左の4つの値を受け入れます。 1に設定されていますが、可読性のために明示的に設定します。

これらのプロパティは、競合することなく一緒に機能します。 IronPrintは構成を検証し、単一の印刷ジョブとしてそれをプリンタードライバーに送信します。 プリンターの選択やトレイ設定のような高度な設定については、完全な印刷設定ガイドを参照してください。

カスタム用紙サイズで非同期印刷する方法は？

メインスレッドをブロックすることが選択肢にないアプリケーション、例えばWPFやWinFormsアプリのために、Printer.PrintAsyncを使用します。 このメソッドは同じTaskを返します。

:path=/static-assets/print/content-code-examples/how-to/set-paper-size/set-paper-size-async-print.cs

using IronPrint;
using System.Threading.Tasks;

public class DocumentPrinter
{
    public async Task PrintLegalDocumentAsync(string filePath)
    {
        // Configure Legal paper size
        PrintSettings settings = new PrintSettings
        {
            PaperSize = PaperSize.Legal,
            PaperOrientation = PaperOrientation.Portrait,
            Dpi = 300
        };

        // Print asynchronously
        await Printer.PrintAsync(filePath, settings);
    }
}

Imports IronPrint
Imports System.Threading.Tasks

Public Class DocumentPrinter
    Public Async Function PrintLegalDocumentAsync(filePath As String) As Task
        ' Configure Legal paper size
        Dim settings As New PrintSettings With {
            .PaperSize = PaperSize.Legal,
            .PaperOrientation = PaperOrientation.Portrait,
            .Dpi = 300
        }

        ' Print asynchronously
        Await Printer.PrintAsync(filePath, settings)
    End Function
End Class

このクラスベースの例は、DocumentPrinterサービスが印刷ロジックをラップする現実的なパターンを示しています。 私たちは、契約および法的提出書類の標準形式であるPaperSize.Legal（8.5×14インチ）を設定します。 awaitキーワードは、IronPrintが印刷ジョブを処理している間に呼び出しスレッドが応答性を保つことを保証します。

このメソッドをボタンクリックハンドラー、バックグラウンドサービス、またはawaitがサポートされている任意の場所から呼び出すことができます。 IronPrintの非同期メソッドは、PrintAsyncやShowPrintDialogAsyncを含み、同じPrintSettings設定を受け入れるので、用紙サイズの動作は同期および非同期のパス間で同一です。

次のステップは何ですか?

私たちは、IronPrintのPaperSize列挙型を使用して用紙サイズを設定する方法を、基本的な単一プロパティ設定から、複合設定、非同期印刷まで説明しました。 PrintSettingsクラスは、用紙寸法についての推測を排除するクリーンで強く型付けされたAPIを提供します。

IronPrintの機能をさらに探るために：

• プリンター名、トレイ、グレースケールを含むすべての印刷設定を構成する方法を学ぶ
• 一般的なシナリオに対する動作する印刷設定のコード例を参照する
• クラスPrinter, PrintSettings, PaperSizeのためのAPIリファレンスを完全に参照します

30日間の無料トライアルを開始して、あなた自身のプロジェクトで用紙サイズの設定をテストする。または、ライセンスオプションを表示して本番環境配備用のライセンスを確認する。

PaperOrientation.Landscape

Dpi

PaperMargins

Margins

Grayscale

false