1. IronPDF
  2. Poradniki
  3. Draw Line & Rectangle
How to Draw Lines and Rectangles on PDFs in C#

Jak rysować linie i prostokąty na PDF-ach w C

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

Aby rysować linie i prostokąty na PDF-ach w C#, użyj metod IronPDF DrawLine i DrawRectangle na obiekcie PdfDocument, określając współrzędne, kolory i wymiary, aby programowo dodawać profesjonalne kształty geometryczne.

Rysowanie linii i prostokątów na dokumencie PDF odnosi się do procesu dodawania kształtów geometrycznych, konkretnie linii i prostokątów, do zawartości pliku PDF. Często robi się to programowo przy użyciu języka programowania jak C# lub VB.NET oraz biblioteki takiej jak IronPDF.

Kiedy rysujesz linię, tworzysz widoczny odcinek o określonych punktach początkowym i końcowym. Podobnie, gdy rysujesz prostokąt, definiujesz czterostronny kształt z określonymi wymiarami i pozycjami. Te możliwości rysowania są niezbędne do tworzenia formularzy, diagramów, adnotacji i podkreślania ważnych sekcji w dokumentach PDF. Funkcje rysowania IronPDF integrują się płynnie z innymi możliwościami edycji PDF, umożliwiając programistom wzbogacanie istniejących PDF-ów lub tworzenie całkowicie nowych dokumentów z niestandardową grafiką.

Szybki start: Rysowanie linii i prostokątów za pomocą IronPDF

Dodawaj linie i prostokąty do swoich dokumentów PDF za pomocą IronPDF. Ten przewodnik pokazuje, jak używać metody DrawLine do rysowania linii i metody DrawRectangle do rysowania prostokątów. Zaledwie kilka linii kodu pozwala tworzyć dynamiczne elementy graficzne w PDF-ach, dodając wizualizacje profesjonalnej jakości do aplikacji.

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Skopiuj i uruchom ten fragment kodu.

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

  3. Wdrożenie do testowania w środowisku produkcyjnym

    Rozpocznij używanie IronPDF w swoim projekcie już dziś z darmową wersją próbną

    arrow pointer

Minimalny proces (5 kroków)

  1. Pobierz bibliotekę IronPDF C# z NuGet
  2. Zaimportuj docelowy dokument PDF lub wyrenderuj go z HTML
  3. Użyj metody DrawLine do dodawania linii do PDF-ów
  4. Użyj metody DrawRectangle do dodawania prostokątów
  5. Eksportuj edytowany dokument PDF


Jak rysować linie na PDF-ach w C#?

Korzystając z metody DrawLine dostępnej dla obiektu PdfDocument, możesz dodawać linie do istniejącego PDF-a. Użycie klasy Color oferowanej przez dokumentację API IronDrawing otwiera możliwość zastosowania linii z kolorem z kodu HEX. Ta funkcja pozwala tworzyć podkreślenia, przegrody, obramowania czy niestandardowe diagramy bezpośrednio w dokumentach PDF.

Metoda DrawLine przyjmuje kilka parametrów, które dają precyzyjną kontrolę nad wyglądem linii:

  • Indeks strony: Określa, na której stronie rysować (indeksowanie zaczyna się od zera)
  • Punkt początkowy: Początkowe współrzędne (X, Y)
  • Punkt końcowy: Końcowe współrzędne (X, Y)
  • Szerokość: Grubość w punktach
  • Kolor: Kolor linii przy użyciu kodów HEX lub zdefiniowanych kolorów
: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

Aby uzyskać więcej zaawansowanych funkcji manipulacji PDF, zapoznaj się z dokumentacją API, która zapewnia kompleksową dokumentację wszystkich dostępnych metod i właściwości.

Jak wygląda wynik rysowania linii?

Zaawansowane techniki rysowania linii

Podczas pracy z liniami w PDF-ach możesz chcieć tworzyć bardziej skomplikowane wzory lub projekty. Oto przykład rysowania wielu linii, aby stworzyć wzór siatki:

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

Technika ta jest szczególnie przydatna przy tworzeniu formularzy lub strukturalnych układów w PDF-ach. Aby uzyskać więcej informacji na temat tworzenia formularzy, odwiedź nasz przewodnik po tworzeniu formularzy PDF.

Jak rysować prostokąty na PDF-ach w C#?

Aby dodać prostokąty do PDF-ów, użyj metody DrawRectangle. Po otwarciu lub wyrenderowaniu dokumentu PDF metoda ta jest dostępna dla obiektu PdfDocument. Skonfiguruj współrzędne, szerokość i wysokość prostokąta za pomocą klasy RectangleF oferowanej przez dokumentację API IronDrawing.

Prostokąty to wszechstronne kształty, które można używać do różnych celów w dokumentach PDF:

  • Tworzenie obramowań wokół ważnej zawartości
  • Podkreślenie sekcji tekstu lub obrazów
  • Budowanie pól formularzy i pól wyboru
  • Projektowanie nagłówków i stopek
  • Tworzenie wizualnych separatorów między sekcjami

Metoda DrawRectangle oferuje opcje zarówno dla obrysów, jak i kolorów wypełnienia, umożliwiając tworzenie obrysowanych prostokątów, wypełnionych prostokątów lub kombinacji obu. Ta elastyczność czyni ją idealną do niestandardowego znakowania wodnego i innych ulepszeń wizualnych.

: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

Jak wygląda wynik rysowania prostokąta?

Tworzenie złożonych układów z prostokątami

Możesz łączyć prostokąty z innymi funkcjami rysowania, aby tworzyć zaawansowane układy. Oto przykład tworzenia szablonu wizytówki:

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

Najlepsze praktyki i wskazówki

Gdy pracujesz z liniami i prostokątami w PDF-ach, rozważ te najlepsze praktyki:

Zrozumienie układu współrzędnych

Układ współrzędnych PDF rozpoczyna się w lewym dolnym rogu strony, gdzie X rośnie w prawo, a Y rośnie w górę. To różni się od wielu układów współrzędnych opartych na ekranie. Zrozumienie tego jest kluczowe dla dokładnego pozycjonowania. Aby uzyskać więcej szczegółów na temat układu strony, zobacz nasz przewodnik po niestandardowych marginesach.

Rozważania dotyczące wydajności

Gdy rysujesz wiele kształtów, wykonuj operacje grupowe, gdy tylko jest to możliwe. Zamiast zapisywać PDF po każdym kształcie, narysuj wszystkie kształty najpierw i zapisz raz. To podejście jest szczególnie ważne przy pracy z dużymi plikami PDF.

Dobór kolorów

Używaj spójnych schematów kolorystycznych w całym dokumencie. Rozważ dostępność, zapewniając wystarczający kontrast między kolorami linii/wypełnienia a tłem. Biblioteka IronDrawing obsługuje różne formaty kolorów, w tym kody HEX, wartości RGB i nazwane kolory.

Integracja z innymi funkcjami

Operacje rysowania działają dobrze z innymi funkcjami IronPDF. Możesz:

  • Rysować na istniejących PDF-ach załadowanych z plików
  • Dodawać kształty do PDF-ów generowanych z HTML
  • Łączyć rysowanie z tekstem i stemplowaniem obrazów
  • Używać rysowania z ustawieniami orientacji strony

Aby uzyskać przykłady tych integracji, zobacz nasze przewodniki po tworzeniu nowych PDF-ów, stemplowaniu tekstu obrazem oraz rotacji orientacji strony.

Obsługa błędów

Zawsze wdrażaj odpowiednią obsługę błędów podczas rysowania na PDF-ach:

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

Pierwsze kroki

Aby rozpocząć korzystanie z możliwości rysowania IronPDF w projekcie, postępuj zgodnie z naszym przeglądem instalacji lub zapoznaj się z przewodnikiem szybkiego startu w celu uzyskania kompleksowego wprowadzenia do IronPDF.

Aby uzyskać bardziej zaawansowane operacje rysowania, w tym dodawanie tekstu i bitmap do PDF-ów, zapoznaj się z naszym przewodnikiem po rysowaniu tekstu i bitmap. Te funkcje, w połączeniu z rysowaniem linii i prostokątów, oferują pełny zestaw narzędzi do dostosowywania i ulepszania PDF-ów.

Często Zadawane Pytania

How do I draw a line on a PDF using C#?

To draw a line on a PDF in C#, use IronPDF's DrawLine method on a PdfDocument object. Simply specify the start and end coordinates, color (as a hex code), and line width. For example: pdf.DrawLine(10, 10, 200, 10, "#FF0000", 2) creates a red horizontal line.

What parameters does the DrawLine method accept?

IronPDF's DrawLine method accepts several parameters: Page Index (which page to draw on), Start Point coordinates (X, Y), End Point coordinates (X, Y), Width (line thickness in points), and Color (using hex codes or predefined colors).

Can I add rectangles to existing PDF documents?

Yes, you can add rectangles to existing PDFs using IronPDF's DrawRectangle method. This method allows you to specify the rectangle's position, dimensions, border color, fill color, and border thickness to create custom shapes on your PDF pages.

What types of geometric shapes can I create on PDFs?

With IronPDF, you can create lines and rectangles on PDF documents. These shapes can be used to create forms, diagrams, annotations, borders, dividers, and to highlight important sections within your PDFs.

Do I need to create a new PDF to add shapes, or can I modify existing ones?

IronPDF allows you to modify existing PDFs by adding shapes. You can load an existing PDF using PdfDocument.FromFile() and then use the drawing methods to add lines and rectangles without creating a new document from scratch.

How can I control the color of shapes in my PDF?

IronPDF supports color customization using hex color codes (like "#FF0000" for red) or predefined colors. The Color class from the IronDrawing API provides additional options for applying colors to your lines and rectangles.

Curtis Chau
Curtis Chau
  Czat z zespołem inżynierów teraz
Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podrę...

Czytaj więcej
Gotowy, aby rozpocząć?
Nuget Pliki do pobrania 18,135,201 | Wersja: 2026.4 just released
Still Scrolling Icon

Wciąż przewijasz?

Czy chcesz szybko dowodu? PM > Install-Package IronPdf
Uruchom przykład i zobacz, jak Twój kod HTML zamienia się w plik PDF.