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

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

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

Aby rysować linie i prostokąty na plikach PDF w języku C#, należy użyć metod DrawLine i DrawRectangle biblioteki 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. W niniejszym przewodniku pokazano, jak używać metody DrawLine dla linii oraz metody DrawRectangle dla 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


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

Korzystając z metody dostępnej dla obiektu, można dodawać linie do istniejącego pliku PDF. Korzystanie z klasy `` oferowanej przez dokumentację API IronDrawing otwiera możliwość zastosowania linii o kolorze z kodu koloru HEX. Ta funkcja pozwala tworzyć podkreślenia, przegrody, obramowania czy niestandardowe diagramy bezpośrednio w dokumentach PDF.

Metoda `` przyjmuje kilka parametrów, które zapewniają 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)
  • Width: Grubość w punktach
  • Color: Kolor linii przy użyciu kodów szesnastkowych lub predefiniowanych 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 skomplikówane 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 plików PDF, użyj metody . Po otwarciu lub wyrenderowaniu dokumentu PDF metoda ta jest dostępna dla obiektu. Skonfiguruj współrzędne, szerokość i wysokość prostokąta za pomocą klasy `` 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 `` udostępnia opcje zarówno dla kolorów konturu, jak i wypełnienia, umożliwiając tworzenie prostokątów z konturem, prostokątów z wypełnieniem lub kombinacji obu tych elementów. 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

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
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,926,724 | Wersja: 2026.5 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.