C#でPDFに線や四角形を描く方法

線画出力はどのように見えますか?

高度な線画テクニック

PDFの行を扱う場合、より複雑なパターンやデザインを作成したい場合があります。 グリッドパターンを作成するために複数の線を引く例です：

// Create a grid pattern with horizontal and vertical lines
for (int i = 0; i < 5; i++)
{
    // Draw horizontal lines
    var horizontalStart = new IronSoftware.Drawing.PointF(100, 100 + (i * 100));
    var horizontalEnd = new IronSoftware.Drawing.PointF(500, 100 + (i * 100));
    pdf.DrawLine(0, horizontalStart, horizontalEnd, 2, new IronSoftware.Drawing.Color("#0000FF"));

    // Draw vertical lines
    var verticalStart = new IronSoftware.Drawing.PointF(100 + (i * 100), 100);
    var verticalEnd = new IronSoftware.Drawing.PointF(100 + (i * 100), 500);
    pdf.DrawLine(0, verticalStart, verticalEnd, 2, new IronSoftware.Drawing.Color("#0000FF"));
}

// Create a grid pattern with horizontal and vertical lines
for (int i = 0; i < 5; i++)
{
    // Draw horizontal lines
    var horizontalStart = new IronSoftware.Drawing.PointF(100, 100 + (i * 100));
    var horizontalEnd = new IronSoftware.Drawing.PointF(500, 100 + (i * 100));
    pdf.DrawLine(0, horizontalStart, horizontalEnd, 2, new IronSoftware.Drawing.Color("#0000FF"));

    // Draw vertical lines
    var verticalStart = new IronSoftware.Drawing.PointF(100 + (i * 100), 100);
    var verticalEnd = new IronSoftware.Drawing.PointF(100 + (i * 100), 500);
    pdf.DrawLine(0, verticalStart, verticalEnd, 2, new IronSoftware.Drawing.Color("#0000FF"));
}

このテクニックは、PDFにフォームや構造化されたレイアウトを作成するときに特に役立ちます。 フォーム作成の詳細については、PDFフォームの作成のガイドをご覧ください。

矩形描画の出力はどのように見えますか?

矩形で複雑なレイアウトを作成する

矩形を他の描画機能と組み合わせて、洗練されたレイアウトを作成できます。 こちらは名刺テンプレートを作成した例です：

// Create a business card template
var cardBorder = new IronSoftware.Drawing.RectangleF(50, 50, 350, 200);
var logoArea = new IronSoftware.Drawing.RectangleF(60, 60, 80, 80);
var textArea = new IronSoftware.Drawing.RectangleF(150, 60, 240, 180);

// Draw the main card border
pdf.DrawRectangle(0, cardBorder, new IronSoftware.Drawing.Color("#000000"), 
                 new IronSoftware.Drawing.Color("#FFFFFF"), 3);

// Draw logo area with light gray background
pdf.DrawRectangle(0, logoArea, new IronSoftware.Drawing.Color("#666666"), 
                 new IronSoftware.Drawing.Color("#F0F0F0"), 1);

// Draw text area border
pdf.DrawRectangle(0, textArea, new IronSoftware.Drawing.Color("#CCCCCC"), 
                 null, 1); // null for no fill

// Create a business card template
var cardBorder = new IronSoftware.Drawing.RectangleF(50, 50, 350, 200);
var logoArea = new IronSoftware.Drawing.RectangleF(60, 60, 80, 80);
var textArea = new IronSoftware.Drawing.RectangleF(150, 60, 240, 180);

// Draw the main card border
pdf.DrawRectangle(0, cardBorder, new IronSoftware.Drawing.Color("#000000"), 
                 new IronSoftware.Drawing.Color("#FFFFFF"), 3);

// Draw logo area with light gray background
pdf.DrawRectangle(0, logoArea, new IronSoftware.Drawing.Color("#666666"), 
                 new IronSoftware.Drawing.Color("#F0F0F0"), 1);

// Draw text area border
pdf.DrawRectangle(0, textArea, new IronSoftware.Drawing.Color("#CCCCCC"), 
                 null, 1); // null for no fill

座標系の理解

PDFの座標系は、ページの左下から始まり、Xは右へ、Yは上へ増加します。 これは、多くの画面ベースの座標系とは異なります。 これを理解することは、正確な位置づけをするために非常に重要です。 ページレイアウトの詳細については、カスタムマージンに関するガイドをご覧ください。

パフォーマンスの考慮事項

複数の図形を描画する場合は、可能な限りバッチ操作を行ってください。 各図形の後にPDFを保存するのではなく、最初にすべての図形を描いてから、一度保存してください。 このアプローチは、大きなPDFファイルを扱う場合に特に重要です。

色の選択

文書全体を通して一貫した配色を使用してください。 線/塗りつぶしの色と背景の間に十分なコントラストを確保することで、アクセシビリティを考慮してください。 IronDrawingライブラリは16進コード、RGB値、名前付きカラーなど様々なカラーフォーマットをサポートしています。

他の機能との統合

描画操作はIronPdfの他の機能とうまく連動します。 できること

• ファイルから読み込んだ既存のPDFに描画
• HTMLから生成されたPDFに図形を追加
• テキストと画像スタンプを組み合わせた描画
• ページの向きを設定して図面を使用する

これらの統合の例については、新しいPDFを作成する、テキスト画像をスタンプする、ページの向きを回転するに関するガイドをご覧ください。

エラーハンドリング

PDFに描画するときは、常に適切なエラー処理を実装してください：

try 
{
    pdf.DrawLine(pageIndex, start, end, width, color);
    pdf.DrawRectangle(pageIndex, rectangle, lineColor, fillColor, lineWidth);
    pdf.SaveAs("output.pdf");
}
catch (Exception ex)
{
    Console.WriteLine($"Error drawing on PDF: {ex.Message}");
    // Handle the error appropriately
}

try 
{
    pdf.DrawLine(pageIndex, start, end, width, color);
    pdf.DrawRectangle(pageIndex, rectangle, lineColor, fillColor, lineWidth);
    pdf.SaveAs("output.pdf");
}
catch (Exception ex)
{
    Console.WriteLine($"Error drawing on PDF: {ex.Message}");
    // Handle the error appropriately
}