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

  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#?

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

:path=/static-assets/pdf/content-code-examples/how-to/draw-line-and-rectangle-3.cs
// 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"));
}
Imports IronSoftware.Drawing

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

    ' Draw vertical lines
    Dim verticalStart As New PointF(100 + (i * 100), 100)
    Dim verticalEnd As New PointF(100 + (i * 100), 500)
    pdf.DrawLine(0, verticalStart, verticalEnd, 2, New 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 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.

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

:path=/static-assets/pdf/content-code-examples/how-to/draw-line-and-rectangle-5.cs
// 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
Icon Quote related to Tworzenie złożonych układów z prostokątami

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 related to Tworzenie złożonych układów z prostokątami

Milan Jovanovic

Microsoft MVP

Zobacz studium przypadku
Icon Quote related to Tworzenie złożonych układów z prostokątami

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 related to Tworzenie złożonych układów z prostokątami

Brent Matzelle

Dyrektor technologiczny, OPYN

Zobacz studium przypadku
Icon Quote related to Tworzenie złożonych układów z prostokątami

IronSuite odgrywa kluczową rolę w naszej działalności. Są to narzędzia zwiększające wydajność w całej firmie, w tym tworzenie planów pięter i poprawa zarządzania zapasami.

David Jones related to Tworzenie złożonych układów z prostokątami

David Jones

Główny inżynier oprogramowania, Agorus Build

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
$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 19,936,792 | Wersja: 2026.7 właśnie wydany
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.