如何在 C# 中 PDF 編輯：繪製直線和矩形

更新:2026年1月10日

Translated

View the article in English

若要在 C# 中在 PDF 上繪製線條和矩形，請使用 IronPDF 的 DrawLine 和 DrawRectangle 方法，在 PdfDocument 物件上指定座標、顏色和尺寸，以程式設計方式新增專業的幾何形狀。

在 PDF 文件上繪製線條和矩形是指向 PDF 文件的內容添加幾何形狀，特別是線條和矩形。這通常是使用 C# 或.NET等程式語言以及IronPDF等程式庫以程式設計方式完成的。

畫線時，你會建立一個具有指定起點和終點的可見線段。同樣地，當你畫一個矩形時，你就定義了一個具有特定尺寸和位置的四邊形。這些繪圖功能對於建立表單、圖表、註釋以及突出顯示 PDF 文件中的重要部分至關重要。 IronPDF 的繪圖功能與其其他PDF 編輯功能無縫集成，使開發人員能夠增強現有 PDF 或使用自訂圖形建立全新的文件。

快速入門：PDF 編輯 — 使用 IronPDF 繪製直線和矩形

使用IronPDF為 PDF 文件新增線條和矩形。本指南示範如何使用 DrawLine 方法繪製直線，以及如何使用 DrawRectangle 方法繪製矩形。只需幾行程式碼，您就可以在 PDF 中建立動態圖形元素，為您的應用程式添加專業品質的視覺效果。

使用NuGet套件管理器安裝https://www.nuget.org/packages/IronPdf
PM > Install-Package IronPdf

複製並運行這段程式碼。

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

部署到您的生產環境進行測試

今天就在您的專案中開始使用免費試用IronPDF

最簡工作流程(5個步驟)

從NuGet下載IronPDF C# 庫
匯入目標 PDF 文件或從 HTML 渲染它
使用`DrawLine`方法為 PDF 新增線條
使用`DrawRectangle`方法新增矩形
匯出已編輯的PDF文檔

如何在C#中在PDF上繪製線條？

透過使用 @@--CODE-544--@@ 物件可用的 @@--CODE-545--@@ 方法，您可以為現有的 PDF 新增一行。使用IronDrawing API 文件提供的Color類，可以實現使用 HEX 顏色代碼為線條應用顏色。此功能可讓您直接在 PDF 文件中建立下劃線、分隔線、邊框或自訂圖表。

DrawLine 方法接受多個參數，讓您精確控制線條的外觀：

-頁面索引：指定要使用的頁面(從零開始索引) -起點：起始座標(X，Y) -終點：終點座標(X，Y) -寬度：以磅為單位的厚度 -顏色：線條顏色，使用十六進位代碼或預先定義顏色

: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")

$vbLabelText $csharpLabel

如需了解更多高級 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

$vbLabelText $csharpLabel

在 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")

$vbLabelText $csharpLabel

矩形繪製輸出結果是什麼樣子的？

使用矩形建立複雜佈局

您可以將矩形與其他繪圖功能結合起來，以建立複雜的佈局。以下是一個建立名片範本的範例：

// 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

$vbLabelText $csharpLabel

最佳實踐和技巧

在處理 PDF 中的線條和矩形時，請遵循以下最佳實踐：

座標系理解

PDF 座標系從頁面左下角開始，X 向右遞增，Y 向上遞增。這與許多基於螢幕的座標係不同。理解這一點對於準確定位至關重要。有關頁面佈局的更多詳細信息，請參閱我們的自訂邊距指南。

性能考量

繪製多個形狀時，盡可能進行批次操作。不要每次繪製完一個形狀後都儲存 PDF，而是先繪製所有形狀，然後一次儲存。這種方法在處理大型 PDF 檔案時尤其重要。

顏色選擇

在整篇文件中使用一致的配色。考慮可視性，確保線條/填充顏色與背景之間有足夠的對比。 IronDrawing 庫支援多種顏色格式，包括十六進位代碼、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

$vbLabelText $csharpLabel

入門

要開始在您的專案中使用 IronPDF 的繪圖功能，請按照我們的安裝概述進行操作，或查看快速入門指南以獲得IronPDF 的全面介紹。

對於更進階的繪圖操作，包括在 PDF 中新增文字和點陣圖，請瀏覽我們的文字和點陣圖繪圖指南。這些功能與線條和矩形繪製相結合，為 PDF 自訂和增強提供了一套完整的工具包。

常見問題解答

如何使用 C# 在 PDF 上畫線？

要使用 C# 在 PDF 上繪製一條線，請在 PdfDocument 物件上使用 IronPDF 的 DrawLine 方法。只需指定起點和終點坐標、顏色（十六進制編碼）和線寬。例如：pdf.DrawLine(10, 10, 200, 10, "#FF0000", 2) 產生一條紅色水平線。

DrawLine 方法接受哪些參數？

IronPDF 的 DrawLine 方法接受幾個參數：Page Index（要在哪一頁上繪製）、Start Point 坐標 (X、Y)、End Point 坐標 (X、Y)、Width（以點為單位的線條粗細）和 Color（使用十六進位代碼或預定義顏色）。

我可以在現有的 PDF 文件中加入矩形嗎？

是的，您可以使用 IronPDF 的 DrawRectangle 方法在現有 PDF 中添加矩形。此方法允許您指定矩形的位置、尺寸、邊框顏色、填充顏色和邊框厚度，以便在 PDF 頁面上創建自定義形狀。

我可以在 PDF 上建立哪些類型的幾何圖形？

使用 IronPDF，您可以在 PDF 文件上創建線條和矩形。這些形狀可用於建立表格、圖表、註解、邊框、分隔線，以及突顯 PDF 文件中的重要部分。

我是否需要建立新的 PDF 來新增圖形，還是可以修改現有的圖形？

IronPDF 允許您透過新增圖形來修改現有的 PDF。您可以使用 PdfDocument.FromFile() 載入現有的 PDF，然後使用繪圖方法新增線條和矩形，而無需從頭建立新的文件。

如何控制 PDF 中圖形的顏色？

IronPDF 支援使用十六進位色碼（如「#FF0000」表示紅色）或預定義顏色自訂顏色。IronDrawing API 中的 Color 類別提供額外的選項，可將顏色套用至您的線條和矩形。

Curtis Chau

立即與工程團隊聊天

技術作家

Curtis Chau 擁有卡爾頓大學計算機科學學士學位，專注於前端開發，擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面，喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外，Curtis 對物聯網 (IoT) 有著濃厚的興趣，探索將硬體和軟體結合的創新方式。在閒暇時間，他喜愛遊戲並構建 Discord 機器人，結合科技與創意的樂趣。

準備好開始了嗎？

Nuget 下載 18,560,885 | 版本： 2026.4 剛剛發布

查看許可證

還在捲動嗎？

想要快速證明？ PM > Install-Package IronPdf
執行範例觀看您的 HTML 變成 PDF。

查看許可證

客戶亮點：

開發者焦點：

網路研討會：

開始 30 天免費試用

在這頁

如何在 C# 中 PDF 編輯：繪製直線和矩形

使用NuGet套件管理器安裝https://www.nuget.org/packages/IronPdf

複製並運行這段程式碼。

部署到您的生產環境進行測試

最簡工作流程(5個步驟)

如何在C#中在PDF上繪製線條？

線框圖的輸出結果是什麼樣子的？

高級線條繪畫技巧

如何在C#中在PDF上繪製矩形？

矩形繪製輸出結果是什麼樣子的？

使用矩形建立複雜佈局

最佳實踐和技巧

座標系理解

性能考量

顏色選擇

與其他功能的集成

錯誤處理

入門

常見問題解答

如何使用 C# 在 PDF 上畫線？

DrawLine 方法接受哪些參數？

我可以在現有的 PDF 文件中加入矩形嗎？

我可以在 PDF 上建立哪些類型的幾何圖形？

我是否需要建立新的 PDF 來新增圖形，還是可以修改現有的圖形？

如何控制 PDF 中圖形的顏色？

還在捲動嗎？

鋼鐵支援團隊

開始 30 天免費試用

在這頁

如何在 C# 中 PDF 編輯：繪製直線和矩形

使用NuGet套件管理器安裝https://www.nuget.org/packages/IronPdf

複製並運行這段程式碼。

部署到您的生產環境進行測試

最簡工作流程(5個步驟)

如何在C#中在PDF上繪製線條？

線框圖的輸出結果是什麼樣子的？

高級線條繪畫技巧

如何在C#中在PDF上繪製矩形？

矩形繪製輸出結果是什麼樣子的？

使用矩形建立複雜佈局

最佳實踐和技巧

座標系理解

性能考量

顏色選擇

與其他功能的集成

錯誤處理

入門

常見問題解答

如何使用 C# 在 PDF 上畫線？

DrawLine 方法接受哪些參數？

我可以在現有的 PDF 文件中加入矩形嗎？

我可以在 PDF 上建立哪些類型的幾何圖形？

我是否需要建立新的 PDF 來新增圖形，還是可以修改現有的圖形？

如何控制 PDF 中圖形的顏色？

還在捲動嗎？

獲取您的免費

Want to deploy IronSuite to a live project for FREE?

What’s included?

Thank You

Want to deploy IronSuite to a live project for FREE?

What’s included?

深受全球數百萬工程師信賴

鋼鐵支援團隊