如何在 C# 中在 PDF 上繪製文字和點陣圖

How to Draw Text and Bitmap on PDFs

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

在PDF上繪製文本和圖像涉及向現有文檔添加文本和圖像。 IronPDF可以無縫實現此功能。 通過加入文本和圖像,使用者可以使用水印、徽標和註釋自定義PDF,提升文檔的視覺外觀和品牌識別。 此外,文本和圖像有助於信息呈現、數據可視化以及創建互動表單。

作為標題:2(快速入門: 使用IronPDF向PDF添加文本和圖像)

快速高效地開始使用IronPDF增強您的PDF文檔,添加文本和圖像。 使用DrawTextDrawBitmap方法,您可以輕鬆自定義您的PDF,無論是添加水印、徽標還是註釋。 此範例展示如何在特定坐標處繪製文本,並無縫地將圖像插入您的PDF,提供文檔自定義的精簡方法。 非常適合希望提高應用品牌化或視覺吸引力的開發人員。

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Copy and run this code snippet.

    new ChromePdfRenderer()
        .RenderHtmlAsPdf("<h1>Doc</h1>")
        .DrawText("Hello World", FontTypes.TimesNewRoman.Name, 12, 0, 100, 100, Color.Black, 0)
        .DrawBitmap(AnyBitmap.FromFile("logo.png"), 0, 50, 250, 500, 300)
        .SaveAs("annotated.pdf");
  3. Deploy to test on your live environment

    Start using IronPDF in your project today with a free trial
    arrow pointer
class="hsg-featured-snippet">

最小工作流程(5步)

  1. 下載C#庫以在PDF上繪製文本和圖像的IronPDF
  2. 導入目標PDF文檔
  3. 使用DrawText方法以所需字體向導入的PDF添加文本
  4. 使用DrawBitmap方法向PDF添加圖像
  5. 導出編輯後的PDF文檔


在PDF上繪製文本範例

通過使用DrawText方法可對PdfDocument對象進行操作,您可以在不改變其原始內容的情況下向現有PDF添加文本。

:path=/static-assets/pdf/content-code-examples/how-to/draw-text-and-bitmap-draw-text.cs
using IronPdf;
using IronSoftware.Drawing;

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

// Draw text on PDF
pdf.DrawText("Some text", FontTypes.TimesNewRoman.Name, FontSize: 12, PageIndex: 0, X: 100, Y: 100, Color.Black, Rotation: 0);

pdf.SaveAs("drawText.pdf");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

FontTypes類中的可用字體

DrawText方法目前支持IronPDF中的所有標準字體,包括Courier、Arial(或Helvetica)、Times New Roman、Symbol和ZapfDingbats。 請訪問管理字體文章中的'IronPDF中的標準字體'部分,了解這些字體類型的斜體、粗體和傾斜變體。

ZapfDingbats字體特別可以用來顯示像 ▲ 這樣的符號。 如需查看支持符號的完整列表,您可以訪問Wikipedia上的Zapf Dingbats

PDF上的字體範例輸出

class="content-img-align-center">
class="center-image-wrapper"> PDF上的字體範例

帶換行的繪製文本

繪製文本操作支持換行字符,允許您渲染帶有內置換行的文本,以提高格式和視覺清晰度。

為此,將換行字符( )添加到文本字符串中。 使用上面的範例,您可以繪製:

string textWithNewlines = "Some text\nSecond line";
pdfDoc.DrawText(textWithNewlines, font, position);
string textWithNewlines = "Some text\nSecond line";
pdfDoc.DrawText(textWithNewlines, font, position);
Imports Microsoft.VisualBasic

Dim textWithNewlines As String = "Some text" & vbLf & "Second line"
pdfDoc.DrawText(textWithNewlines, font, position)
$vbLabelText   $csharpLabel

使用自定義字體

我們還支持使用DrawText方法的自定義字體; 以下是一個添加Pixelify Sans Font文本的範例。

:path=/static-assets/pdf/content-code-examples/how-to/draw-text-and-bitmap-draw-custom-font.cs
using IronPdf;
using IronSoftware.Drawing;
using System.IO;

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

// Add custom font to the PDF
byte[] fontByte = File.ReadAllBytes(@".\PixelifySans-VariableFont_wght.ttf");
var addedFont = pdf.Fonts.Add(fontByte);

// Draw text on PDF
pdf.DrawText("Iron Software", addedFont.Name, FontSize: 12, PageIndex: 0, X: 100, Y: 600, Color.Black, Rotation: 0);

pdf.SaveAs("drawCustomFont.pdf");
Imports IronPdf
Imports IronSoftware.Drawing
Imports System.IO

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

' Add custom font to the PDF
Private fontByte() As Byte = File.ReadAllBytes(".\PixelifySans-VariableFont_wght.ttf")
Private addedFont = pdf.Fonts.Add(fontByte)

' Draw text on PDF
pdf.DrawText("Iron Software", addedFont.Name, FontSize:= 12, PageIndex:= 0, X:= 100, Y:= 600, Color.Black, Rotation:= 0)

pdf.SaveAs("drawCustomFont.pdf")
$vbLabelText   $csharpLabel

繪製圖像範例

使用IronPDF的DrawBitmap方法,您可以輕鬆地向現有PDF文檔添加位圖。 此方法的功能類似於圖像加蓋功能,允許您將圖像加蓋到現有PDF上。

請注意The DrawBitmap方法最適用於大圖像。 當嘗試使用較小解析度的圖像時,您可能會遇到以下异常:IronPdf.Exceptions.IronPdfNativeException: '繪製圖像時出錯:數據長度(567000)小於預期(756000)'。要克服此問題,您可以使用Image Stamper,該工具可以無縫處理各種大小的圖像。

範例圖像

class="content-img-align-center">
class="center-image-wrapper"> 1200 x 627 圖像

代码

:path=/static-assets/pdf/content-code-examples/how-to/draw-text-and-bitmap-draw-bitmap.cs
using IronPdf;
using IronSoftware.Drawing;

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

// Open the image from file
AnyBitmap bitmap = AnyBitmap.FromFile("ironSoftware.png");

// Draw the bitmp on PDF
pdf.DrawBitmap(bitmap, 0, 50, 250, 500, 300);

pdf.SaveAs("drawImage.pdf");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

輸出PDF

DrawBitmap額外參數

  • PixelFormat: PixelFormat屬性指定位圖的色彩數據格式,主要控制其對透明度的支持。 默認值為Format32bppArgb。 開發人員可以通過將參數作為選項傳遞,選擇像素枚舉格式Format32bppRgbFormat32bppArgb

  • IgnorePageRotation: 該bool屬性指定在繪製位圖時方法是否忽略頁面旋轉。 默認值為false。 特別適用於您需要在所有頁面上一致地應用水印而不考慮旋轉的情況。

準備看看您還能做哪些其他事情嗎? 在這裡查看我們的教程頁面:編輯PDF

常見問題解答

如何使用 C# 在 PDF 上繪製文字和圖像?

您可以使用 IronPDF 的DrawText方法為 PDF 添加文本,並使用DrawBitmap方法添加圖像。首先,從 NuGet 下載 IronPDF 庫,匯入您的 PDF 文件,新增文字或圖像,然後匯出編輯後的文件。

在PDF中新增文字時支援哪些字體?

IronPDF 支援 Courier、Arial (Helvetica)、Times New Roman、Symbol 和 ZapfDingbats 等標準字體。您也可以在使用DrawText方法時指定自訂字型檔案來使用自訂字型。

如何使用 C# 為 PDF 新增帶有換行符的文字?

要在 IronPDF 中新增帶有換行符的文本,請在使用DrawText方法時,在文本字串中包含換行符('\n')。這樣可以更好地格式化文本,使其更清晰、更易於組織。

我可以在PDF文件中使用自訂字體嗎?

是的,IronPDF 支援自訂字體。您可以在使用DrawText方法時指定自訂字型文件,以便在 PDF 中新增獨特的字型。

如果在PDF上繪製影像時遇到錯誤,我該怎麼辦?

如果遇到錯誤,尤其是小圖像錯誤,請考慮使用 IronPDF 的圖像標記功能,該功能可以無縫處理各種尺寸的圖像,並防止常見的異常情況。

如何在C#中將HTML轉換為PDF?

您可以使用 IronPDF 的RenderHtmlAsPdf方法將 HTML 字串轉換為 PDF。您也可以使用RenderHtmlFileAsPdf將 HTML 檔案轉換為 PDF。

我該如何開始使用 IronPDF 編輯 PDF 檔案?

首先從 NuGet 下載 IronPDF 庫。然後,匯入所需的 PDF 文檔,使用DrawTextDrawBitmap方法添加文字或圖像,最後匯出編輯後的文檔。

IronPDF 是否完全相容於 .NET 10,能夠用於繪製文字和圖像?

是的,IronPDF 可以開箱即用地與 .NET 10 搭配使用。它支援所有主要版本,包括 .NET 10,無需任何特殊設定。您可以在 .NET 10 應用程式中使用DrawTextDrawBitmap等方法,就像在早期版本中一樣。 IronPDF 的產品文件中已明確確認其與 .NET 10 的兼容性。

A PHP Error was encountered

Severity: Warning

Message: Illegal string offset 'name'

Filename: sections/author_component.php

Line Number: 18

Backtrace:

File: /var/www/ironpdf.com/application/views/main/sections/author_component.php
Line: 18
Function: _error_handler

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 63
Function: view

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 64
Function: main_view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

A PHP Error was encountered

Severity: Warning

Message: Illegal string offset 'title'

Filename: sections/author_component.php

Line Number: 38

Backtrace:

File: /var/www/ironpdf.com/application/views/main/sections/author_component.php
Line: 38
Function: _error_handler

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 63
Function: view

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 64
Function: main_view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

A PHP Error was encountered

Severity: Warning

Message: Illegal string offset 'comment'

Filename: sections/author_component.php

Line Number: 48

Backtrace:

File: /var/www/ironpdf.com/application/views/main/sections/author_component.php
Line: 48
Function: _error_handler

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 63
Function: view

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 64
Function: main_view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

準備好開始了嗎?
Nuget 下載 16,133,208 | 版本: 2025.11 剛剛發布