如何在C#中於PDF中繪製線條和矩形

已更新:2026年6月3日

Translated

View the article in English

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

將線條和矩形繪製到PDF文件意味著將特定的幾何圖形，尤其是線條和矩形，新增到PDF文件的內容中。這通常使用像C#或VB.NET這樣的程式語言和像IronPDF這樣的程式庫來程式設計完成。

當您畫一條線時，您會建立一個具體位置起點和終點的可見線段。同樣地，當您畫一個矩形時，您會定義一個有具體尺寸和位置的四邊形。這些繪製能力對於建立表單、圖表、註釋和在PDF文件中突出顯示重要部分都是必要的。 IronPDF的繪製功能與其其他PDF編輯功能完美整合，允許開發人員增強現有的PDF或建立具有自定義圖形的全新文件。

快速入門：使用IronPDF繪製線條和矩形

使用IronPDF在您的PDF文件中新增線條和矩形。本指南演示如何使用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中畫線？

通過利用PdfDocument物件，您可以在現有的PDF中新增線條。使用IronDrawing API文件中提供的Color類，您可以從HEX顏色程式碼應用線條顏色。此功能允許您直接在PDF文件中建立底線、分隔線、邊框或自定義圖表。

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

頁索引：指定哪一頁繪製（零基索引）
起點：起始座標（X, Y）
終點：結束座標（X, Y）
Width：厚度（點）
Color：使用十六進制程式碼或預定義顏色定義的線條顏色

: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中工作時，您可能希望建立更複雜的圖案或設計。以下是一個使用多條線建立網格圖案的例子：

:path=/static-assets/pdf/content-code-examples/how-to/draw-line-and-rectangle-3.cs

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

Imports IronSoftware.Drawing

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

    ' Draw vertical lines
    Dim verticalStart As New PointF(100 + (i * 100), 100)
    Dim verticalEnd As New PointF(100 + (i * 100), 500)
    pdf.DrawLine(0, verticalStart, verticalEnd, 2, New 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

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

用矩形建立複雜佈局

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

:path=/static-assets/pdf/content-code-examples/how-to/draw-line-and-rectangle-5.cs

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

我最喜歡的程式庫是IronPDF。它允許快速高效地操作PDF文件。它還有許多有價值的功能，例如導出到PDF/A格式和數位簽署PDF文件。

Milan Jovanovic

Microsoft MVP

查看案例研究

IronOCR意味著我們每年可以從手動處理中節省$40,000，同時提高生產力，釋放資源以進行高影響的任務。我會強烈推薦它。

Brent Matzelle

首席技術官，OPYN

查看案例研究

最佳實踐和提示

在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上繪製線條，使用IronPDF的DrawLine方法應用於PdfDocument物件。只需指定起始和結束座標、顏色（作為十六進制程式碼）以及線條寬度。例如：pdf.DrawLine(10, 10, 200, 10, "#FF0000", 2) 會建立一條紅色水平線。

DrawLine方法接受哪些參數？

IronPDF的DrawLine方法接受多個參數：頁面索引（繪製哪一頁）、起點座標（X, Y）、終點座標（X, Y）、寬度（以點為單位的線條厚度）和顏色（使用十六進制程式碼或預定義顏色）。

我可以在現有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擁有Carleton大學的電腦科學學士學位，專精於前端開發，擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面，喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

除了開發，Curtis對物聯網（IoT）有濃厚的興趣，探索創新的方法來整合硬體和軟體。在空閒時間，他喜歡玩遊戲和建立Discord機器人，結合他對技術的熱愛與創造力。

準備開始了嗎？

Nuget 下載 20,296,129 | 版本： 2026.7 剛剛發布

查看授權

還在捲動嗎？

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

查看授權

客戶亮點：

開發者聚焦：

網路研討會：

開始免費30天試用

此頁面上

如何在C#中於PDF中繪製線條和矩形

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

複製並運行這段程式碼片段。

部署以在您的實時環境中測試

最小工作流程 (5步)

如何在C#中於PDF中畫線？

線條繪製輸出結果是什麼樣的？

高級線條繪製技術

如何在C#中於PDF中畫矩形？

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

用矩形建立複雜佈局

Milan Jovanovic

Brent Matzelle

David Jones

最佳實踐和提示

理解座標系

性能考量

選擇顏色

與其他功能的整合

錯誤處理

開始使用

常見問題

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

DrawLine方法接受哪些參數？

我可以在現有PDF文件中新增矩形嗎？

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

我需要建立一個新的PDF來新增形狀嗎，還是可以修改現有的？

如何控制我PDF中形狀的顏色？

還在捲動嗎？

您的授權金鑰已經發送到您的收件箱

您的演示請求已提交。

Iron 支援團隊

開始免費30天試用

此頁面上

如何在C#中於PDF中繪製線條和矩形

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

複製並運行這段程式碼片段。

部署以在您的實時環境中測試

最小工作流程 (5步)

如何在C#中於PDF中畫線？

線條繪製輸出結果是什麼樣的？

高級線條繪製技術

如何在C#中於PDF中畫矩形？

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

用矩形建立複雜佈局

Milan Jovanovic

Brent Matzelle

David Jones

最佳實踐和提示

理解座標系

性能考量

選擇顏色

與其他功能的整合

錯誤處理

開始使用

常見問題

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

DrawLine方法接受哪些參數？

我可以在現有PDF文件中新增矩形嗎？

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

我需要建立一個新的PDF來新增形狀嗎，還是可以修改現有的？

如何控制我PDF中形狀的顏色？

還在捲動嗎？

立即獲取免費

下一步：開始免費30天試用

Thank You

下一步：開始免費30天試用

想免費將 IronSuite 部署到實際專案中嗎？

包含什麼？

您的授權金鑰已經發送到您的收件箱

您的演示請求已提交。

受到全球數百萬工程師的信任

Iron 支援團隊