IRONSOFTWAREHOME

C#을 사용하여 PDF에 선과 사각형을 그리는 방법

Curtis Chau
Curtis Chau
Updated: 2026년 6월 4일

C#에서 IronPDF의 DrawLineDrawRectangle 메서드를 사용하여 PDF에 선과 사각형을 그려 프로그래밍 방식으로 전문가적인 기하학적 도형을 추가하세요. 좌표, 색상, 치수를 지정하세요.

PDF 문서에 선과 사각형을 그리는 것은 PDF 파일의 내용에 기하학적 도형, 특히 선과 사각형을 추가하는 과정을 말합니다. 이는 일반적으로 C#이나 VB .NET 과 같은 프로그래밍 언어와 IronPDF 와 같은 라이브러리를 사용하여 프로그래밍 방식으로 수행됩니다.

선을 그리면 지정된 시작점과 끝점을 가진 보이는 선분이 생성됩니다. 마찬가지로 직사각형을 그릴 때에도 지정된 크기와 위치를 가진 네 변으로 이루어진 도형을 정의하게 됩니다. 이러한 그리기 기능은 PDF 문서에서 양식, 다이어그램, 주석을 만들고 중요한 부분을 강조 표시하는 데 필수적입니다. IronPDF의 그리기 기능은 다른 PDF 편집 기능 과 완벽하게 통합되어 개발자가 기존 PDF를 개선하거나 사용자 지정 그래픽을 사용하여 완전히 새로운 문서를 만들 수 있습니다.

빠른 시작: IronPDF 로 선과 사각형 그리기

IronPDF 사용하여 PDF 문서에 선과 사각형을 추가하세요. 이 가이드는 선을 위한 DrawLine 메서드와 사각형을 위한 DrawRectangle 메서드 사용 방법을 설명합니다. 단 몇 줄의 코드로 PDF에 동적인 그래픽 요소를 추가하여 애플리케이션에 전문가 수준의 시각 자료를 더할 수 있습니다.

  1. 1Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. 2다음 코드 조각을 복사하여 실행하세요.

    IronPdf.PdfDocument pdf = IronPdf.PdfDocument.FromFile("input.pdf");
    pdf.DrawLine(10, 10, 200, 10, "#FF0000", 2);
    pdf.SaveAs("output.pdf");
    C#
  3. 3실제 운영 환경에서 테스트할 수 있도록 배포하세요.

    무료 체험판으로 오늘 프로젝트에서 IronPDF 사용 시작하기
    arrow pointer

C#에서 PDF에 선을 그리는 방법은 무엇인가요?

PdfDocument 객체를 위한 DrawLine 메서드를 활용하여 기존 PDF에 선을 추가할 수 있습니다. IronDrawing API 문서에서 제공하는 Color 클래스를 사용하여 색상에서 HEX 색상 코드를 사용하여 선을 그릴 수 있습니다. 이 기능을 사용하면 PDF 문서 내에서 직접 밑줄, 구분선, 테두리 또는 사용자 지정 다이어그램을 만들 수 있습니다.

DrawLine 메서드는 선의 모양을 정밀하게 제어할 수 있는 여러 매개변수를 허용합니다:

  • 페이지 인덱스 : 그림을 그릴 페이지를 지정합니다(0부터 시작하는 인덱스).
  • 시작점 : 시작 좌표(X, Y)
  • 종착점 : 최종 좌표(X, Y)
  • Width: 두께는 포인트 단위
  • Color: 선 색상은 헥스 코드나 사전 정의된 색상 사용
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");

보다 고급적인 PDF 조작 기능에 대해서는 모든 메서드와 속성에 대한 자세한 설명이 포함된 API 참조를 확인하세요.

선 그림 출력 결과는 어떻게 나타나나요?

고급 선 그리기 기법

PDF에서 선을 다룰 때, 더 복잡한 패턴이나 디자인을 만들고 싶을 수도 있습니다. 다음은 여러 개의 선을 그려 격자 무늬를 만드는 예입니다.

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

이 기법은 PDF에서 양식이나 구조화된 레이아웃을 만들 때 특히 유용합니다. 양식 생성에 대한 자세한 내용은 PDF 양식 생성 가이드를 참조하세요.

C#에서 PDF에 사각형을 그리는 방법은 무엇인가요?

PDF에 사각형을 추가하려면 DrawRectangle 메서드를 사용하세요. PDF 문서를 열거나 렌더링하면 이 메서드는 PdfDocument 객체를 위해 사용할 수 있습니다. IronDrawing API 문서에서 제공하는 RectangleF 클래스로 사각형의 좌표, 너비, 높이를 구성하세요.

직사각형은 PDF 문서에서 다양한 용도로 사용할 수 있는 다재다능한 도형입니다.

  • 중요 콘텐츠 주변에 테두리 만들기
  • 텍스트 또는 이미지의 특정 부분을 강조 표시합니다.
  • 폼 필드 및 체크박스 생성
  • 헤더 및 푸터 디자인
  • 섹션 간 시각적 구분선 만들기

DrawRectangle 메서드는 윤곽선과 채우기 색상 옵션을 제공하여 윤곽선 사각형, 채워진 사각형 또는 둘의 조합을 만들 수 있습니다. 이러한 유연성 덕분에 맞춤형 워터마킹 및 기타 시각적 향상 작업에 이상적입니다.

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

사각형 그리기 결과물은 어떤 모습인가요?

직사각형을 이용하여 복잡한 레이아웃 만들기

사각형을 다른 그리기 기능과 결합하여 정교한 레이아웃을 만들 수 있습니다. 다음은 명함 템플릿을 만드는 예시입니다.

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

이 종류의 라이브러리 중 가장 좋아하는 것은 IronPDF입니다. PDF 파일을 빠르고 효율적으로 조작할 수 있습니다. 또한 PDF/A 형식으로 내보내기 및 PDF 문서의 디지털 서명과 같은 많은 유용한 기능을 가지고 있습니다.

Milan Jovanovic

마이크로소프트 MVP

사례 연구 보기

IronOCR 덕분에 연간 $40,000를 수동 프로세싱에서 절약하고 생산성을 높이며 고부가가치 작업에 자원을 활용할 수 있습니다. 강력히 추천합니다.

브렌트 마첼

최고 기술 책임자, OPYN

사례 연구 보기

IronSuite는 우리의 운영에서 중요한 역할을 합니다. 이것들은 사업 전반에 걸쳐 효율성을 높이는 도구로, 평면도 생성 및 재고 관리 개선을 포함합니다.

데이비드 존스

리드 소프트웨어 엔지니어, Agorus Build

사례 연구 보기

모범 사례 및 팁

PDF에서 선과 사각형을 다룰 때는 다음과 같은 모범 사례를 고려하십시오.

좌표계 이해

PDF 좌표계는 페이지의 왼쪽 아래 모서리에서 시작하며, X축은 오른쪽으로 갈수록 커지고 Y축은 위쪽으로 갈수록 커집니다. 이는 화면 기반 좌표계와는 다릅니다. 정확한 위치 파악을 위해서는 이 점을 이해하는 것이 매우 중요합니다. 페이지 레이아웃에 대한 자세한 내용은 사용자 지정 여백 가이드를 참조하세요.

성능 고려 사항

여러 도형을 그릴 때는 가능한 한 일괄 작업을 활용하세요. 도형을 하나씩 그릴 때마다 PDF를 저장하는 대신, 모든 도형을 먼저 그린 다음 한 번에 저장하세요. 이러한 접근 방식은 특히 대용량 PDF 파일을 다룰 때 중요합니다.

색상 선택

문서 전체에 일관된 색상 구성을 사용하십시오. 선/채우기 색상과 배경색 사이에 충분한 대비를 확보하여 접근성을 고려하십시오. IronDrawing 라이브러리는 16진수 코드, RGB 값, 명명된 색상을 포함한 다양한 색상 형식을 지원합니다.

다른 기능과의 통합

도면 작업은 IronPDF 다른 기능들과 잘 연동됩니다. 다음과 같은 일을 할 수 있습니다:

  • 파일에서 불러온 기존 PDF에 그림을 그립니다. HTML에서 생성된 PDF에 도형을 추가합니다.
  • 그림과 텍스트 및 이미지 스탬핑을 결합합니다
  • 페이지 방향 설정을 사용하여 그림을 그리세요

이러한 통합의 예는 새 PDF 생성 , 스탬프 텍스트 이미지페이지 방향 회전 에 대한 가이드를 참조하세요.

오류 처리

PDF에 그림을 그릴 때는 항상 적절한 오류 처리를 구현해야 합니다.

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
}

시작하기

프로젝트에서 IronPDF의 도면 기능을 사용하려면 설치 개요를 따르거나 IronPDF 에 대한 포괄적인 소개가 포함된 빠른 시작 가이드를 참조하십시오.

PDF에 텍스트와 비트맵을 추가하는 등 고급 그리기 작업을 하려면 텍스트 및 비트맵 그리기 가이드를 참조하세요. 이러한 기능은 선 및 사각형 그리기 기능과 결합되어 PDF 사용자 정의 및 향상을 위한 완벽한 도구를 제공합니다.

자주 묻는 질문

C#을 사용하여 PDF에 선을 그리는 방법은 무엇인가요?

C#에서 PDF에 선을 그리려면 IronPDF의 PdfDocument 객체에 있는 DrawLine 메서드를 사용하면 됩니다. 시작 및 끝 좌표, 색상(16진수 코드), 선 두께를 지정하기만 하면 됩니다. 예를 들어, pdf.DrawLine(10, 10, 200, 10, "#FF0000", 2)는 빨간색 가로선을 그립니다.

DrawLine 메서드는 어떤 매개변수를 받습니까?

IronPDF의 DrawLine 메서드는 페이지 인덱스(그림을 그릴 페이지), 시작점 좌표(X, Y), 끝점 좌표(X, Y), 선 두께(포인트 단위), 색상(16진수 코드 또는 미리 정의된 색상 사용) 등 여러 매개변수를 허용합니다.

기존 PDF 문서에 사각형을 추가할 수 있나요?

네, IronPDF의 DrawRectangle 메서드를 사용하여 기존 PDF에 사각형을 추가할 수 있습니다. 이 메서드를 사용하면 사각형의 위치, 크기, 테두리 색상, 채우기 색상 및 테두리 두께를 지정하여 PDF 페이지에 사용자 지정 모양을 만들 수 있습니다.

PDF에서 어떤 종류의 기하학적 도형을 만들 수 있나요?

IronPDF를 사용하면 PDF 문서에 선과 사각형을 만들 수 있습니다. 이러한 도형은 양식, 다이어그램, 주석, 테두리, 구분선을 만들거나 PDF 내의 중요한 부분을 강조하는 데 사용할 수 있습니다.

도형을 추가하려면 새 PDF 파일을 만들어야 하나요, 아니면 기존 도형을 수정할 수 있나요?

IronPDF를 사용하면 기존 PDF에 도형을 추가하여 수정할 수 있습니다. PdfDocument.FromFile()을 사용하여 기존 PDF를 불러온 다음, 그리기 메서드를 사용하여 새 문서를 처음부터 만들지 않고도 선과 사각형을 추가할 수 있습니다.

PDF 파일에서 도형의 색상을 어떻게 제어할 수 있나요?

IronPDF는 16진수 색상 코드(예: 빨간색의 경우 "#FF0000") 또는 미리 정의된 색상을 사용하여 색상 사용자 지정을 지원합니다. IronDrawing API의 Color 클래스는 선과 사각형에 색상을 적용하는 추가 옵션을 제공합니다.

How can performance be optimized when drawing multiple shapes on a PDF?

For better performance, batch drawing operations by adding all shapes before saving the PDF. This minimizes the saving process, especially useful with large PDF files.

Does IronPDF allow integration of drawing features with other PDF functionalities?

Yes, IronPDF's drawing features integrate with other functionalities such as PDF editing, HTML rendering, and text or image stamping, providing a versatile toolset for PDF customization.

What error handling strategies should be used when drawing on PDFs with IronPDF?

Implementing proper error handling is important. Wrap drawing operations in try-catch blocks to handle exceptions and ensure error messages are appropriately logged or displayed.

Curtis Chau
기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

...
더 읽어보기

시작할 준비 되셨나요?

Nuget Downloads 20,756,830버전:2026.7방금 출시

무료로 받기

30일 체험 키를 즉시 받으세요.

bullet_checked신용카드나 계정 생성은 필요하지 않습니다.
bullet_test워터마크 없이
프로덕션에서 테스트
bullet_calendar30일 완전한
기능의 제품
bullet_support체험 기간 동안
24/5 기술 지원
지금 바로 30일 무료 체험판 키를 받으세요.
신용카드나 계정 생성은 필요하지 않습니다.
PDF용 C# NuGet 라이브러리
NuGet을 사용하여 설치하세요

버전: 2026.7

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. 솔루션 탐색기에서 참조를 마우스 오른쪽 버튼으로 클릭하고 NuGet 패키지 관리를 선택합니다.
  2. 찾아보기를 선택하고 "IronPDF"를 검색하세요.
  3. 패키지를 선택하고 설치하세요
C# PDF DLL
DLL 다운로드

버전: 2026.7

또는 여기에서 Windows 설치 프로그램을 다운로드하십시오.

  1. IronPDF를 다운로드하고 솔루션 디렉터리 내의 ~/Libs와 같은 위치에 압축을 푸세요.
  2. Visual Studio 솔루션 탐색기에서 참조를 마우스 오른쪽 버튼으로 클릭합니다. 찾아보기를 선택하고 "IronPDF.dll"을 선택합니다.

라이선스 가격은 749달러 부터 시작합니다.

Key in blue circle

무료 30일 체험 키를 즉시 받으세요.

Your trial license will be sent to your email address

제한 없음. 100% 무제한 이용. 신용카드 불필요.

bullet_checked신용카드나 계정 생성은 필요하지 않습니다.제한 없음. 100% 무제한 이용. 신용카드 불필요.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
무료 라이브 데모를 예약하세요
Booking Badge

전 세계 수백만 엔지니어들이 신뢰하는 제품입니다.

Iron Software의 고객 로고
부담 없는 무료 상담을 받아보세요
아래 양식을 작성하시거나 sales@ironsoftware.com으로 이메일을 보내주세요.
고객님의 정보는 항상 비밀로 유지됩니다.
전 세계 수백만 엔지니어들이 신뢰하는 제품입니다.
Iron Software의 고객 로고
지금 바로 30일 무료 체험판 키를 받으세요.
신용카드나 계정 생성은 필요하지 않습니다.