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

Updated: 4 czerwca 2026

Aby rysować linie i prostokąty na PDF-ach w C#, użyj metod DrawLine i DrawRectangle IronPDF 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. Przewodnik ten pokazuje, jak używać metody DrawLine do linii i metody DrawRectangle do prostokątów. Zaledwie kilka linii kodu pozwala tworzyć dynamiczne elementy graficzne w PDF-ach, dodając wizualizacje profesjonalnej jakości do aplikacji.

1Install IronPDF with NuGet Package Manager
PM > Install-Package IronPdf
```
Install-Package IronPdf
```

2Skopiuj 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");

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

3Wdrożenie do testowania w środowisku produkcyjnym

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

Minimalny proces (5 kroków)

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

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

Wykorzystując metodę DrawLine dostępną dla obiektu PdfDocument, można dodawać linie do istniejącego PDF-a. Użycie klasy Color oferowanej przez IronDrawing API Documentation otwiera możliwość zastosowania linii z kolorem pochodzącym z kodu kolorów HEX. Ta funkcja pozwala tworzyć podkreślenia, przegrody, obramowania czy niestandardowe diagramy bezpośrednio w dokumentach PDF.

Metoda DrawLine akceptuje kilka parametrów, które dają precyzyjną kontrolę nad wyglądem twoich 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)
Width: Grubość w punktach
Color: Kolor linii używając kodów hex lub wstępnie zdefiniowanych kolorów

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

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

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

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 As New IronSoftware.Drawing.PointF(100, 100 + (i * 100))
    Dim horizontalEnd As New IronSoftware.Drawing.PointF(500, 100 + (i * 100))
    pdf.DrawLine(0, horizontalStart, horizontalEnd, 2, New IronSoftware.Drawing.Color("#0000FF"))

    ' Draw vertical lines
    Dim verticalStart As New IronSoftware.Drawing.PointF(100 + (i * 100), 100)
    Dim verticalEnd As New IronSoftware.Drawing.PointF(100 + (i * 100), 500)
    pdf.DrawLine(0, verticalStart, verticalEnd, 2, New IronSoftware.Drawing.Color("#0000FF"))
Next

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

    ' Draw vertical lines
    Dim verticalStart As New IronSoftware.Drawing.PointF(100 + (i * 100), 100)
    Dim verticalEnd As New IronSoftware.Drawing.PointF(100 + (i * 100), 500)
    pdf.DrawLine(0, verticalStart, verticalEnd, 2, New IronSoftware.Drawing.Color("#0000FF"))
Next

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 dodawać 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 IronDrawing API Documentation.

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 kolorów konturów, jak i wypełnienia, pozwalając tworzyć prostokąty z konturami, wypełnieniem, lub kombinacją obu. Ta elastyczność czyni ją idealną do niestandardowego znakowania wodnego i innych ulepszeń wizualnych.

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

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

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

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

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

Moją ulubioną biblioteką tego typu jest IronPDF. Umożliwia ona szybkie i efektywne manipulowanie plikami PDF. Posiada także wiele cennych funkcji, takich jak eksport do formatu PDF/A i cyfrowe podpisywanie dokumentów PDF.

Milan Jovanovic

Microsoft MVP

Zobacz studium przypadku

IronOCR pozwala nam oszczędzić 40 000 USD rocznie na ręcznym przetwarzaniu, jednocześnie zwiększając produktywność i uwalniając zasoby do zadań o wysokim wpływie. Gorąco polecam.

Brent Matzelle

Dyrektor technologiczny, OPYN

Zobacz studium przypadku

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

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

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

Jak narysować linię na pliku PDF używając C#?

Aby narysować linię na pliku PDF w C#, użyj metody DrawLine na obiekcie PdfDocument w IronPDF. Wystarczy określić współrzędne początkowe i końcowe, kolor (jako kod hex) i szerokość linii. Na przykład: pdf.DrawLine(10, 10, 200, 10, "#FF0000", 2) tworzy czerwoną poziomą linię.

Jakie parametry akceptuje metoda DrawLine?

Metoda DrawLine w IronPDF akceptuje kilka parametrów: indeks strony (na której stronie rysować), współrzędne punktu początkowego (X, Y), współrzędne punktu końcowego (X, Y), szerokość (grubość linii w punktach) i kolor (używając kodów hex lub zdefiniowanych kolorów).

Czy mogę dodawać prostokąty do istniejących dokumentów PDF?

Tak, możesz dodawać prostokąty do istniejących plików PDF używając metody DrawRectangle w IronPDF. Ta metoda pozwala określić położenie prostokąta, wymiary, kolor obramowania, kolor wypełnienia i grubość obramowania, aby tworzyć na stronach PDF niestandardowe kształty.

Jakie typy kształtów geometrycznych mogę tworzyć w plikach PDF?

Z IronPDF możesz tworzyć linie i prostokąty w dokumentach PDF. Te kształty mogą być używane do tworzenia formularzy, diagramów, adnotacji, ramek, podziałów i podkreślania ważnych sekcji w Twoich plikach PDF.

Czy muszę tworzyć nowy PDF, aby dodać kształty, czy mogę modyfikować istniejące?

IronPDF pozwala modyfikować istniejące pliki PDF, dodając kształty. Możesz załadować istniejący PDF przy użyciu PdfDocument.FromFile() a następnie użyć metod rysowania, aby dodać linie i prostokąty bez tworzenia nowego dokumentu od zera.

Jak mogę kontrolować kolor kształtów w moim pliku PDF?

IronPDF obsługuje dostosowywanie koloru za pomocą kodów kolorów hex (jak "#FF0000" dla czerwieni) lub zdefiniowanych kolorów. Klasa Color z API IronDrawing oferuje dodatkowe opcje stosowania kolorów do linii i prostokątów.

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ęczników.

...

Czytaj więcej