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

Updated: 2026年9月17日

C# で PDF に線や長方形を描画するには、IronPDF の DrawLine メソッドと DrawRectangle メソッドを PdfDocument オブジェクトで使用し、座標、色、寸法を指定してプログラム的にプロフェッショナルな幾何学的形状を追加します。

PDFドキュメントに線と矩形を描くことは、PDFファイルの内容に幾何学形状、特に線と矩形を追加するプロセスを指します。これは通常、C#やVB.NETのようなプログラミング言語とIronPDFのようなライブラリを使用してプログラム的に行われます。

線を描くと、指定された始点と終点のある視覚的な線分が作成されます。同様に、矩形を描くと、指定された寸法と位置のある四辺形の形を定義します。これらの描画機能は、フォーム、ダイアグラム、注釈を作成したり、PDF文書で重要な部分を強調表示したりするために不可欠です。 IronPDFの描画機能は他のPDF編集機能とシームレスに統合されており、開発者は既存のPDFを強化したり、カスタムグラフィックを含む全く新しいドキュメントを作成することができます。

クイックスタート: IronPDFで線と四角形を描く

IronPDFを使用してPDF文書に線や矩形を追加します。このガイドでは、線用の DrawLine メソッドと長方形用の DrawRectangle メソッドを使用する方法を示します。わずか数行のコードで、PDFに動的なグラフィック要素を作成し、アプリケーションにプロ品質のビジュアルを追加することができます。

1Install IronPDF with NuGet Package Manager
PM > Install-Package IronPdf
```
Install-Package IronPdf
```

2このコードスニペットをコピーして実行します。

IronPdf.PdfDocument pdf = IronPdf.PdfDocument.FromFile("input.pdf");
pdf.DrawLine(10, 10, 200, 10, "#FF0000", 2);
pdf.SaveAs("output.pdf");

IronPdf.PdfDocument pdf = IronPdf.PdfDocument.FromFile("input.pdf");
pdf.DrawLine(10, 10, 200, 10, "#FF0000", 2);
pdf.SaveAs("output.pdf");

3実際の環境でテストするためにデプロイする

今日プロジェクトで IronPDF を使い始めましょう無料トライアル

最小限のワークフロー（5ステップ）

NuGetからIronPDF C#ライブラリをダウンロードする。
ターゲットの PDF ドキュメントをインポートするか、HTML からレンダリングします。
DrawLineメソッドを使ってPDFに線を追加する
矩形を追加するには、DrawRectangleメソッドを使用してください。
編集した PDF ドキュメントをエクスポートします。

C#でPDFに線を引くには?

PdfDocument オブジェクトに利用可能な DrawLine メソッドを利用することで、既存の PDF に線を追加できます。 IronDrawing API ドキュメントで提供される Color クラスを使用すると、HEX カラーコードから色を指定して線を適用する可能性が開きます。この機能により、PDF文書内で直接、下線、仕切り、ボーダー、カスタムダイアグラムを作成することができます。

DrawLine メソッドは、線の外観を正確にコントロールするいくつかのパラメータを受け入れます。

ページインデックス：描画するページを指定します（ゼロベースインデックス）。
開始点：開始座標（X、Y）
終了点: 終了座標 (X, Y)
Width: ポイントでの太さ
Color: 16進数コードまたは定義済みの色を使用した線の色

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>testing</h1>");

// Configure the required parameters
int pageIndex = 0;
var start = new IronSoftware.Drawing.PointF(200,150);
var end = new IronSoftware.Drawing.PointF(1000,150);
int width = 10;
var color = new IronSoftware.Drawing.Color("#000000");

// Draw line on PDF
pdf.DrawLine(pageIndex, start, end, width, color);

pdf.SaveAs("drawLine.pdf");

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>testing</h1>");

// Configure the required parameters
int pageIndex = 0;
var start = new IronSoftware.Drawing.PointF(200,150);
var end = new IronSoftware.Drawing.PointF(1000,150);
int width = 10;
var color = new IronSoftware.Drawing.Color("#000000");

// Draw line on PDF
pdf.DrawLine(pageIndex, start, end, width, color);

pdf.SaveAs("drawLine.pdf");

Imports IronPdf

Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>testing</h1>")

' Configure the required parameters
Private pageIndex As Integer = 0
Private start = New IronSoftware.Drawing.PointF(200,150)
Private [end] = New IronSoftware.Drawing.PointF(1000,150)
Private width As Integer = 10
Private color = New IronSoftware.Drawing.Color("#000000")

' Draw line on PDF
pdf.DrawLine(pageIndex, start, [end], width, color)

pdf.SaveAs("drawLine.pdf")

Imports IronPdf

Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>testing</h1>")

' Configure the required parameters
Private pageIndex As Integer = 0
Private start = New IronSoftware.Drawing.PointF(200,150)
Private [end] = New IronSoftware.Drawing.PointF(1000,150)
Private width As Integer = 10
Private color = New IronSoftware.Drawing.Color("#000000")

' Draw line on PDF
pdf.DrawLine(pageIndex, start, [end], width, color)

pdf.SaveAs("drawLine.pdf")

より高度なPDF操作機能については、APIリファレンスをご覧ください。利用可能なすべてのメソッドとプロパティの包括的なドキュメントを提供しています。

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

高度な線画テクニック

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"));
}

' Create a grid pattern with horizontal and vertical lines
For i As Integer = 0 To 4
    ' Draw horizontal lines
    Dim horizontalStart As New IronSoftware.Drawing.PointF(100, 100 + (i * 100))
    Dim horizontalEnd As New IronSoftware.Drawing.PointF(500, 100 + (i * 100))
    pdf.DrawLine(0, horizontalStart, horizontalEnd, 2, New IronSoftware.Drawing.Color("#0000FF"))

    ' Draw vertical lines
    Dim verticalStart As New IronSoftware.Drawing.PointF(100 + (i * 100), 100)
    Dim verticalEnd As New IronSoftware.Drawing.PointF(100 + (i * 100), 500)
    pdf.DrawLine(0, verticalStart, verticalEnd, 2, New IronSoftware.Drawing.Color("#0000FF"))
Next

' Create a grid pattern with horizontal and vertical lines
For i As Integer = 0 To 4
    ' Draw horizontal lines
    Dim horizontalStart As New IronSoftware.Drawing.PointF(100, 100 + (i * 100))
    Dim horizontalEnd As New IronSoftware.Drawing.PointF(500, 100 + (i * 100))
    pdf.DrawLine(0, horizontalStart, horizontalEnd, 2, New IronSoftware.Drawing.Color("#0000FF"))

    ' Draw vertical lines
    Dim verticalStart As New IronSoftware.Drawing.PointF(100 + (i * 100), 100)
    Dim verticalEnd As New IronSoftware.Drawing.PointF(100 + (i * 100), 500)
    pdf.DrawLine(0, verticalStart, verticalEnd, 2, New IronSoftware.Drawing.Color("#0000FF"))
Next

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

C#でPDFに矩形を描くには?

PDF に長方形を追加するには、DrawRectangle メソッドを使用します。 PDF ドキュメントが開かれるかレンダリングされると、このメソッドは PdfDocument オブジェクトで利用可能です。 IronDrawing API ドキュメントで提供される RectangleF クラスを使用して、長方形の座標、幅、高さを設定します。

矩形は、PDF文書でさまざまな目的に使用できる汎用性の高い図形です：

重要なコンテンツを囲む境界線の作成
テキストや画像のハイライト
フォームフィールドとチェックボックスの作成
ヘッダーとフッターのデザイン
セクション間の視覚的なセパレータの作成

DrawRectangle メソッドは、輪郭色および塗りつぶし色のオプションを提供し、輪郭長方形、塗りつぶされた長方形、またはその両方の組み合わせを作成することができます。この柔軟性により、カスタム透かしやその他の視覚的強化に最適です。

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>testing</h1>");

// Configure the required parameters
int pageIndex = 0;
var rectangle = new IronSoftware.Drawing.RectangleF(200, 100, 1000, 100);
var lineColor = new IronSoftware.Drawing.Color("#000000");
var fillColor = new IronSoftware.Drawing.Color("#32AB90");
int lineWidth = 5;

// Draw rectangle on PDF
pdf.DrawRectangle(pageIndex, rectangle, lineColor, fillColor, lineWidth);

pdf.SaveAs("drawRectangle.pdf");

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>testing</h1>");

// Configure the required parameters
int pageIndex = 0;
var rectangle = new IronSoftware.Drawing.RectangleF(200, 100, 1000, 100);
var lineColor = new IronSoftware.Drawing.Color("#000000");
var fillColor = new IronSoftware.Drawing.Color("#32AB90");
int lineWidth = 5;

// Draw rectangle on PDF
pdf.DrawRectangle(pageIndex, rectangle, lineColor, fillColor, lineWidth);

pdf.SaveAs("drawRectangle.pdf");

Imports IronPdf

Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>testing</h1>")

' Configure the required parameters
Private pageIndex As Integer = 0
Private rectangle = New IronSoftware.Drawing.RectangleF(200, 100, 1000, 100)
Private lineColor = New IronSoftware.Drawing.Color("#000000")
Private fillColor = New IronSoftware.Drawing.Color("#32AB90")
Private lineWidth As Integer = 5

' Draw rectangle on PDF
pdf.DrawRectangle(pageIndex, rectangle, lineColor, fillColor, lineWidth)

pdf.SaveAs("drawRectangle.pdf")

Imports IronPdf

Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>testing</h1>")

' Configure the required parameters
Private pageIndex As Integer = 0
Private rectangle = New IronSoftware.Drawing.RectangleF(200, 100, 1000, 100)
Private lineColor = New IronSoftware.Drawing.Color("#000000")
Private fillColor = New IronSoftware.Drawing.Color("#32AB90")
Private lineWidth As Integer = 5

' Draw rectangle on PDF
pdf.DrawRectangle(pageIndex, rectangle, lineColor, fillColor, lineWidth)

pdf.SaveAs("drawRectangle.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

Imports IronSoftware.Drawing

' Create a business card template
Dim cardBorder As New RectangleF(50, 50, 350, 200)
Dim logoArea As New RectangleF(60, 60, 80, 80)
Dim textArea As New RectangleF(150, 60, 240, 180)

' Draw the main card border
pdf.DrawRectangle(0, cardBorder, New Color("#000000"), New Color("#FFFFFF"), 3)

' Draw logo area with light gray background
pdf.DrawRectangle(0, logoArea, New Color("#666666"), New Color("#F0F0F0"), 1)

' Draw text area border
pdf.DrawRectangle(0, textArea, New Color("#CCCCCC"), Nothing, 1) ' Nothing for no fill

Imports IronSoftware.Drawing

' Create a business card template
Dim cardBorder As New RectangleF(50, 50, 350, 200)
Dim logoArea As New RectangleF(60, 60, 80, 80)
Dim textArea As New RectangleF(150, 60, 240, 180)

' Draw the main card border
pdf.DrawRectangle(0, cardBorder, New Color("#000000"), New Color("#FFFFFF"), 3)

' Draw logo area with light gray background
pdf.DrawRectangle(0, logoArea, New Color("#666666"), New Color("#F0F0F0"), 1)

' Draw text area border
pdf.DrawRectangle(0, textArea, New Color("#CCCCCC"), Nothing, 1) ' Nothing for no fill

私のお気に入りのこの種のライブラリはIronPDFです。PDFファイルの迅速で効率的な操作が可能です。また、PDF/A形式へのエクスポートやPDF文書へのデジタル署名といった多くの貴重な機能も備えています。

Milan Jovanovic

Microsoft MVP

ケーススタディを見る

IronOCRのおかげで私たちは年間$40,000を手作業の処理から節約し、生産性を向上させ、高影響のタスクにリソースを充てることができます。非常にお勧めします。

Brent Matzelle

最高技術責任者, OPYN

ケーススタディを見る

ベストプラクティスとヒント

PDFで線や矩形を扱う場合は、以下のベストプラクティスを考慮してください：

座標系の理解

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
}

Imports System

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

Imports System

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

開始方法

あなたのプロジェクトでIronPDFの描画機能を使い始めるには、インストールの概要に従うか、クイックスタートガイドでIronPDFの包括的な紹介をご覧ください。

PDFにテキストやビットマップを追加するなど、より高度な描画操作については、テキストとビットマップを描画するのガイドをご覧ください。これらの機能は、線と矩形の描画と組み合わされ、PDFのカスタマイズと拡張のための完全なツールキットを提供します。

よくある質問

C# を使って PDF に線を引くにはどうすればよいですか？

C#でPDFに線を引くには、PdfDocumentオブジェクトにIronPDFのDrawLineメソッドを使用します。開始座標と終了座標、色(16進コード)、線幅を指定するだけです。例えば、pdf.DrawLine(10, 10, 200, 10, "#FF0000", 2) は赤い水平線を作成します。

DrawLineメソッドはどのようなパラメータを受け付けますか？

IronPDFのDrawLineメソッドにはいくつかのパラメータがあります：ページインデックス(どのページに描画するか)、開始点座標(X, Y)、終了点座標(X, Y)、幅(ポイント単位の線の太さ)、色(16進コードまたは定義済みの色を使用)。

既存のPDF文書に矩形を追加できますか？

はい、IronPDFのDrawRectangleメソッドを使って既存のPDFに矩形を追加することができます。このメソッドでは矩形の位置、寸法、枠線の色、塗りつぶしの色、枠線の太さを指定し、PDFページにカスタム形状を作成することができます。

PDFにはどのような幾何学図形を作成できますか？

IronPDFを使えば、PDFドキュメント上に線や矩形を作成することができます。これらの図形は、フォーム、ダイアグラム、注釈、境界線、仕切り、PDF内の重要なセクションを強調するために使用できます。

図形を追加するには、新しいPDFを作成する必要がありますか。

IronPDFは図形を追加することで既存のPDFを修正することができます。PdfDocument.FromFile()を使って既存のPDFを読み込み、描画メソッドを使って線や矩形を追加することができます。

PDFの図形の色を制御するにはどうすればよいですか？

IronPDFは16進カラーコード(赤は "#FF0000 "など)や定義済みの色を使った色のカスタマイズをサポートしています。IronDrawing APIのColorクラスは線や矩形に色を適用するための追加オプションを提供します。

How can performance be optimized when drawing multiple shapes on a PDF?

For better performance, batch drawing operations by adding all shapes before saving the PDF. This minimizes the saving process, especially useful with large PDF files.

Does IronPDF allow integration of drawing features with other PDF functionalities?

Yes, IronPDF's drawing features integrate with other functionalities such as PDF editing, HTML rendering, and text or image stamping, providing a versatile toolset for PDF customization.

What error handling strategies should be used when drawing on PDFs with IronPDF?

Implementing proper error handling is important. Wrap drawing operations in try-catch blocks to handle exceptions and ensure error messages are appropriately logged or displayed.

Curtis Chau

今すぐエンジニアリングチームとチャット

テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

...

詳しく読む