C#でPDFに線や四角形を描いてPDF 編集を行う方法
C# で PDF に線や四角形を描画するには、IronPDF の DrawLine メソッドと DrawRectangle メソッドを PdfDocument オブジェクトで使用し、座標、色、寸法を指定して、プロフェッショナルな幾何学的図形をプログラムで追加します。
PDFドキュメントに線と矩形を描くことは、PDFファイルの内容に幾何学形状、特に線と矩形を追加するプロセスを指します。これは通常、C#やVB.NETのようなプログラミング言語とIronPDFのようなライブラリを使用してプログラム的に行われます。
線を描くと、指定された始点と終点のある視覚的な線分が作成されます。 同様に、矩形を描くと、指定された寸法と位置のある四辺形の形を定義します。 これらの描画機能は、フォーム、ダイアグラム、注釈を作成したり、PDF文書で重要な部分を強調表示したりするために不可欠です。 IronPDFの描画機能は他のPDF編集機能とシームレスに統合されており、開発者は既存のPDFを強化したり、カスタムグラフィックを含む全く新しいドキュメントを作成することができます。
クイックスタート: IronPDFでPDFに線と四角形を描いてPDF 編集する
IronPDFを使用してPDF文書に線や矩形を追加します。 このガイドでは、線に DrawLine メソッドを使用し、四角形に DrawRectangle メソッドを使用する方法を説明します。 わずか数行のコードで、PDFに動的なグラフィック要素を作成し、アプリケーションにプロ品質のビジュアルを追加することができます。
最小限のワークフロー(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)
- 幅:ポイント単位の太さ
- 色: 16進コードまたは定義済みの色を使用した線の色。
:path=/static-assets/pdf/content-code-examples/how-to/draw-line-and-rectangle-draw-line.cs
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")
より高度な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 = New IronSoftware.Drawing.PointF(100, 100 + (i * 100))
Dim horizontalEnd = New IronSoftware.Drawing.PointF(500, 100 + (i * 100))
pdf.DrawLine(0, horizontalStart, horizontalEnd, 2, New IronSoftware.Drawing.Color("#0000FF"))
' Draw vertical lines
Dim verticalStart = New IronSoftware.Drawing.PointF(100 + (i * 100), 100)
Dim verticalEnd = 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 メソッドは、アウトラインと塗りつぶしの両方の色のオプションを提供し、アウトラインされた四角形、塗りつぶされた四角形、またはその両方の組み合わせを作成できます。 この柔軟性により、カスタム透かしやその他の視覚的強化に最適です。
:path=/static-assets/pdf/content-code-examples/how-to/draw-line-and-rectangle-draw-rectangle.cs
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")
矩形描画の出力はどのように見えますか?
矩形で複雑なレイアウトを作成する
矩形を他の描画機能と組み合わせて、洗練されたレイアウトを作成できます。 こちらは名刺テンプレートを作成した例です:
// 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
ベストプラクティスとヒント
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
開始方法
あなたのプロジェクトで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クラスは線や矩形に色を適用するための追加オプションを提供します。

