วิธีการเพิ่มส่วนประกอบแบบดรอปดาวน์ลงในเอกสาร PDF โดยใช้ GroupDocs.Annotation สำหรับ .NET

Install-Package GroupDocs.Annotation -Version 25.4.0

dotnet add package GroupDocs.Annotation --version 25.4.0

using GroupDocs.Annotation;

// สร้างการเริ่มต้นวัตถุ Annotator ด้วยเส้นทางไปยังเอกสาร PDF ของคุณ
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" },
    
    // ปล่อยให้ตัวเลือกที่เลือกไว้เป็นค่าว่างในตอนแรก
    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, 150) กว้าง 200 สูง 40
dropdown.Box = new Rectangle(200, 150, 200, 40);

// เปลี่ยนสีปากกาเป็นสีแดง (ค่า RGB)
dropdown.PenColor = 16711680; // สีแดงใน RGB

// เปลี่ยนรูปแบบปากกา
dropdown.PenStyle = PenStyle.Solid; // ตัวเลือก: Solid, Dash, Dot, DashDot ฯลฯ

// ปรับความกว้างของปากกา
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");
}