.NET용 GroupDocs.Annotation을 사용하여 PDF 문서에 드롭다운 구성 요소를 추가하는 방법

Install-Package GroupDocs.Annotation -Version 25.4.0

dotnet add package GroupDocs.Annotation --version 25.4.0

using GroupDocs.Annotation;

// PDF 문서 경로로 Annotator 객체를 초기화합니다.
Annotator annotator = new Annotator("YOUR_DOCUMENT_DIRECTORY/input.pdf");

using GroupDocs.Annotation;
using System;

string inputPdfPath = "YOUR_DOCUMENT_DIRECTORY/input.pdf";
string outputPath = Path.Combine("YOUR_OUTPUT_DIRECTORY/result.pdf");

// 새로운 드롭다운 구성요소 만들기
DropdownComponent dropdown = new DropdownComponent
{
    // 드롭다운에 나타날 옵션을 정의하세요
    Options = new List<string> { "Item1", "Item2", "Item3" },
    
    // 선택한 옵션을 처음에는 null로 둡니다.
    SelectedOption = null,
    
    // 플레이스홀더 텍스트 추가
    Placeholder = "Choose option",
    
    // 드롭다운의 위치와 크기(X, Y, 너비, 높이)를 설정합니다.
    Box = new Rectangle(100, 100, 100, 100),
    
    // 생성 타임스탬프 설정
    CreatedOn = DateTime.Now,
    
    // 드롭다운에 메시지/도구 설명 추가
    Message = "This is dropdown component",
    
    // 페이지 번호 설정(0부터 시작하는 인덱스)
    PageNumber = 0,
    
    // 펜 색상을 설정합니다(65535는 RGB에서 파란색을 나타냄)
    PenColor = 65535,
    
    // 펜 스타일 설정
    PenStyle = PenStyle.Dot,
    
    // 펜 폭 설정
    PenWidth = 3
};

// 드롭다운에 답변/댓글 추가
dropdown.Replies = new List<Reply>
{
    new Reply
    {
        Comment = "First comment",
        RepliedOn = DateTime.Now
    },
    new Reply
    {
        Comment = "Second comment",
        RepliedOn = DateTime.Now
    }
};

// 문서에 드롭다운 구성 요소를 추가합니다.
annotator.Add(dropdown);

// 추가된 드롭다운으로 문서를 저장합니다.
annotator.Save(outputPath);

using System;
using System.IO;
using System.Collections.Generic;
using GroupDocs.Annotation;
using GroupDocs.Annotation.Models;
using GroupDocs.Annotation.Models.FormatSpecificComponents.Pdf;

namespace GroupDocs.Annotation.Examples
{
    class AddDropdownComponentExample
    {
        public static void Run()
        {
            Console.WriteLine("Adding dropdown component to a PDF document...");
            
            // 입력 및 출력 경로 정의
            string inputPath = "YOUR_DOCUMENT_DIRECTORY/input.pdf";
            string outputPath = "YOUR_OUTPUT_DIRECTORY/output-with-dropdown.pdf";
            
            // 입력 문서로 주석자를 초기화합니다.
            using (Annotator annotator = new Annotator(inputPath))
            {
                // 드롭다운 구성 요소 만들기
                DropdownComponent dropdown = new DropdownComponent
                {
                    // 드롭다운 옵션 정의
                    Options = new List<string> { "Option 1", "Option 2", "Option 3", "Option 4" },
                    SelectedOption = null,
                    Placeholder = "Select an option...",
                    
                    // 위치 및 크기
                    Box = new Rectangle(100, 100, 150, 30),
                    
                    // 메타데이터
                    CreatedOn = DateTime.Now,
                    Message = "Please select one option from the dropdown",
                    PageNumber = 0,
                    
                    // 스타일링
                    PenColor = 65535,  // 파란색
                    PenStyle = PenStyle.Solid,
                    PenWidth = 2,
                    
                    // 선택 사항
                    Replies = new List<Reply>
                    {
                        new Reply
                        {
                            Comment = "This dropdown is for demonstration purposes",
                            RepliedOn = DateTime.Now
                        }
                    }
                };
                
                // 문서에 드롭다운 추가
                annotator.Add(dropdown);
                
                // 주석이 달린 문서를 저장합니다
                annotator.Save(outputPath);
                
                Console.WriteLine($"Dropdown component added successfully.\nCheck the output file at: {outputPath}");
            }
        }
    }
}

// 너비 200, 높이 40의 좌표(200, 150)에 위치
dropdown.Box = new Rectangle(200, 150, 200, 40);

// 펜 색상을 빨간색(RGB 값)으로 변경합니다.
dropdown.PenColor = 16711680; // RGB의 빨간색

// 펜 스타일 변경
dropdown.PenStyle = PenStyle.Solid; // 옵션: 단색, 대시, 점, 대시닷 등.

// 펜 폭 조절
dropdown.PenWidth = 2;

// 예: 데이터베이스 또는 API에서 옵션 로드
List<string> dynamicOptions = GetOptionsFromDataSource();
dropdown.Options = dynamicOptions;

// 예시 도우미 메서드(구현은 다를 수 있음)
private static List<string> GetOptionsFromDataSource()
{
    // 실제 응용 프로그램에서는 이것이 데이터베이스에서 나올 수 있습니다.
    return new List<string> { "Value 1", "Value 2", "Value 3" };
}

// 자원의 적절한 처리를 보장하세요
using (Annotator annotator = new Annotator(inputPath))
{
    // 여러 개의 드롭다운 추가
    for (int i = 0; i < numberOfDropdowns; i++)
    {
        // 드롭다운을 만들고 추가하세요
        DropdownComponent dropdown = CreateDropdown(i);
        annotator.Add(dropdown);
    }
    
    annotator.Save(outputPath);
} // 리소스는 여기에 적절하게 배치됩니다.

// 로드 옵션을 사용하여 메모리 사용을 최적화하세요
LoadOptions loadOptions = new LoadOptions
{
    // 대용량 문서에 대한 특정 옵션 설정
};

using (Annotator annotator = new Annotator(inputPath, loadOptions))
{
    // 드롭다운 구성요소를 추가하세요
    // ...
}

dropdown.Options = new List<string> { "Option 1", "Option 2", "Option 3" };
dropdown.SelectedOption = "Option 2"; // 기본 선택을 설정합니다

using (Annotator annotator = new Annotator("submitted-form.pdf"))
{
    // 드롭다운을 포함한 모든 주석 가져오기
    List<AnnotationBase> annotations = annotator.Get();
    
    // 드롭다운 구성 요소 찾기
    foreach (var annotation in annotations)
    {
        if (annotation is DropdownComponent dropdown)
        {
            Console.WriteLine($"Selected value: {dropdown.SelectedOption}");
        }
    }
}

using (Annotator annotator = new Annotator("document-with-dropdown.pdf"))
{
    // 모든 주석 가져오기
    List<AnnotationBase> annotations = annotator.Get();
    
    // 드롭다운 찾기 및 업데이트
    foreach (var annotation in annotations)
    {
        if (annotation is DropdownComponent dropdown)
        {
            // 속성 업데이트
            dropdown.PenColor = 255; // 빨간색으로 변경
            dropdown.Options = new List<string> { "New Option 1", "New Option 2" };
            
            // 주석을 업데이트하세요
            annotator.Update(dropdown);
        }
    }
    
    // 업데이트된 문서를 저장합니다
    annotator.Save("updated-document.pdf");
}