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

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

用紙サイズは、PrintSettings オブジェクトの PaperSize プロパティに 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 を PaperSize.Letter に上書きします。これにより、標準的な 8.5 × 11 インチのフォーマットにマッピングされます。 Printer.Print を呼び出すと、IronPrint はその用紙サイズを使用して、ドキュメントをシステムのデフォルトプリンターに送信します。

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

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

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

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

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

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

PrintSettings クラスは、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 は、Margins コンストラクタを通じて、ミリメートル単位の 4 つの値（上、右、下、左）を受け取ります。 CopyCount プロパティのデフォルト値は 1 ですが、可読性を高めるために明示的に設定しています。

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

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

WPF や WinForms アプリケーションなど、メインスレッドをブロックできないアプリケーションでは、Printer.PrintAsync を使用します。 このメソッドは同じ PrintSettings オブジェクトを受け取り、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 サービスがPRINTロジックをラップする、現実的なパターンを示しています。 契約書や法的書類の標準フォーマットである PaperSize.Legal（8.5 × 14 インチ）で設定します。 await キーワードを使用することで、IronPrintが印刷ジョブを処理している間も、呼び出し元のスレッドが応答性を維持できるようになります。

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

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

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

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

• プリンター名、トレイ、グレースケールを含むすべての印刷設定を構成する方法を学ぶ
• 一般的なシナリオに対する動作する印刷設定のコード例を参照する
• PaperSize などのクラスについては、APIリファレンスの全文をご覧ください。

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

PaperOrientation.Landscape

Dpi

PaperMargins

Margins

Grayscale

false