Cách thêm thành phần thả xuống vào tài liệu PDF bằng GroupDocs.Annotation cho .NET

Install-Package GroupDocs.Annotation -Version 25.4.0

dotnet add package GroupDocs.Annotation --version 25.4.0

using GroupDocs.Annotation;

// Khởi tạo đối tượng Annotator với đường dẫn đến tài liệu PDF của bạn.
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");

// Tạo một thành phần thả xuống mới
DropdownComponent dropdown = new DropdownComponent
{
    // Xác định các tùy chọn sẽ xuất hiện trong danh sách thả xuống
    Options = new List<string> { "Item1", "Item2", "Item3" },
    
    // Để tùy chọn đã chọn ở trạng thái null ban đầu
    SelectedOption = null,
    
    // Thêm một văn bản giữ chỗ
    Placeholder = "Choose option",
    
    // Đặt vị trí và kích thước của menu thả xuống (X, Y, Chiều rộng, Chiều cao)
    Box = new Rectangle(100, 100, 100, 100),
    
    // Đặt dấu thời gian tạo
    CreatedOn = DateTime.Now,
    
    // Thêm thông báo/công cụ chú giải cho menu thả xuống
    Message = "This is dropdown component",
    
    // Đặt số trang (chỉ mục dựa trên 0)
    PageNumber = 0,
    
    // Đặt màu bút (65535 biểu thị màu xanh lam trong RGB)
    PenColor = 65535,
    
    // Thiết lập kiểu bút
    PenStyle = PenStyle.Dot,
    
    // Đặt chiều rộng của bút
    PenWidth = 3
};

// Thêm trả lời/bình luận vào danh sách thả xuống
dropdown.Replies = new List<Reply>
{
    new Reply
    {
        Comment = "First comment",
        RepliedOn = DateTime.Now
    },
    new Reply
    {
        Comment = "Second comment",
        RepliedOn = DateTime.Now
    }
};

// Thêm thành phần thả xuống vào tài liệu
annotator.Add(dropdown);

// Lưu tài liệu với danh sách thả xuống đã thêm
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...");
            
            // Xác định đường dẫn đầu vào và đầu ra
            string inputPath = "YOUR_DOCUMENT_DIRECTORY/input.pdf";
            string outputPath = "YOUR_OUTPUT_DIRECTORY/output-with-dropdown.pdf";
            
            // Khởi tạo chú thích với tài liệu đầu vào
            using (Annotator annotator = new Annotator(inputPath))
            {
                // Tạo một thành phần thả xuống
                DropdownComponent dropdown = new DropdownComponent
                {
                    // Xác định tùy chọn thả xuống
                    Options = new List<string> { "Option 1", "Option 2", "Option 3", "Option 4" },
                    SelectedOption = null,
                    Placeholder = "Select an option...",
                    
                    // Vị trí và kích thước
                    Box = new Rectangle(100, 100, 150, 30),
                    
                    // Siêu dữ liệu
                    CreatedOn = DateTime.Now,
                    Message = "Please select one option from the dropdown",
                    PageNumber = 0,
                    
                    // Kiểu dáng
                    PenColor = 65535,  // Màu xanh
                    PenStyle = PenStyle.Solid,
                    PenWidth = 2,
                    
                    // Bình luận tùy chọn
                    Replies = new List<Reply>
                    {
                        new Reply
                        {
                            Comment = "This dropdown is for demonstration purposes",
                            RepliedOn = DateTime.Now
                        }
                    }
                };
                
                // Thêm menu thả xuống vào tài liệu
                annotator.Add(dropdown);
                
                // Lưu tài liệu có chú thích
                annotator.Save(outputPath);
                
                Console.WriteLine($"Dropdown component added successfully.\nCheck the output file at: {outputPath}");
            }
        }
    }
}

// Vị trí tại tọa độ (200, 150) với chiều rộng 200 và chiều cao 40
dropdown.Box = new Rectangle(200, 150, 200, 40);

// Đổi màu bút thành màu đỏ (giá trị RGB)
dropdown.PenColor = 16711680; // Màu đỏ trong RGB

// Thay đổi kiểu bút
dropdown.PenStyle = PenStyle.Solid; // Tùy chọn: Solid, Dash, Dot, DashDot, v.v.

// Điều chỉnh độ rộng của bút
dropdown.PenWidth = 2;

// Ví dụ: Tải tùy chọn từ cơ sở dữ liệu hoặc API
List<string> dynamicOptions = GetOptionsFromDataSource();
dropdown.Options = dynamicOptions;

// Ví dụ về phương pháp trợ giúp (việc triển khai sẽ khác nhau)
private static List<string> GetOptionsFromDataSource()
{
    // Trong một ứng dụng thực tế, điều này có thể đến từ một cơ sở dữ liệu
    return new List<string> { "Value 1", "Value 2", "Value 3" };
}

// Đảm bảo xử lý tài nguyên đúng cách
using (Annotator annotator = new Annotator(inputPath))
{
    // Thêm nhiều danh sách thả xuống
    for (int i = 0; i < numberOfDropdowns; i++)
    {
        // Tạo và thêm menu thả xuống
        DropdownComponent dropdown = CreateDropdown(i);
        annotator.Add(dropdown);
    }
    
    annotator.Save(outputPath);
} // Tài nguyên được phân bổ hợp lý ở đây

// Sử dụng tùy chọn tải để tối ưu hóa việc sử dụng bộ nhớ
LoadOptions loadOptions = new LoadOptions
{
    // Đặt các tùy chọn cụ thể cho các tài liệu lớn
};

using (Annotator annotator = new Annotator(inputPath, loadOptions))
{
    // Thêm các thành phần thả xuống của bạn
    // ...
}

dropdown.Options = new List<string> { "Option 1", "Option 2", "Option 3" };
dropdown.SelectedOption = "Option 2"; // Đặt lựa chọn mặc định

using (Annotator annotator = new Annotator("submitted-form.pdf"))
{
    // Nhận tất cả các chú thích bao gồm cả danh sách thả xuống
    List<AnnotationBase> annotations = annotator.Get();
    
    // Tìm các thành phần thả xuống
    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"))
{
    // Nhận tất cả chú thích
    List<AnnotationBase> annotations = annotator.Get();
    
    // Tìm và cập nhật danh sách thả xuống
    foreach (var annotation in annotations)
    {
        if (annotation is DropdownComponent dropdown)
        {
            // Cập nhật thuộc tính
            dropdown.PenColor = 255; // Đổi sang màu đỏ
            dropdown.Options = new List<string> { "New Option 1", "New Option 2" };
            
            // Cập nhật chú thích
            annotator.Update(dropdown);
        }
    }
    
    // Lưu tài liệu đã cập nhật
    annotator.Save("updated-document.pdf");
}