كيفية إضافة مكون القائمة المنسدلة إلى مستند PDF باستخدام GroupDocs.Annotation لـ .NET

Install-Package GroupDocs.Annotation -Version 25.4.0

dotnet add package GroupDocs.Annotation --version 25.4.0

using GroupDocs.Annotation;

// قم بتهيئة كائن المعلق باستخدام المسار إلى مستند 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; // الخيارات: صلب، شرطة، نقطة، DashDot، وما إلى ذلك.

// ضبط عرض القلم
dropdown.PenWidth = 2;

// مثال: خيارات التحميل من قاعدة بيانات أو واجهة برمجة التطبيقات
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");
}