1. IronPDF
  2. 操作指南
  3. 畫線及矩形
如何在 C# 中在 PDF 上繪製線條和矩形

如何在 C# 中在 PDF 上繪製直線和矩形

Curtis Chau
Curtis Chau
更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

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

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

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

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

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

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

    PM > Install-Package IronPdf

  2. 複製並運行這段程式碼。

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

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

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

    arrow pointer

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

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


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

透過使用 @@--CODE-545--CODE-544 --CODE-545 物件可用的 @@--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");
$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"));
}
$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");
$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
$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
}
$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
  立即與工程團隊聊天
技術作家

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

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

準備好開始了嗎？
Nuget 下載 17,803,474 | 版本： 2026.3 剛剛發布
Still Scrolling Icon

還在滾動嗎？

想快速取得證據？ PM > Install-Package IronPdf
運行範例看著你的HTML程式碼變成PDF檔。