أزرار الراديو أفقيًا وعموديًا

مقدمة

إن إنشاء نماذج PDF تفاعلية يمكن أن يعزز بشكل كبير من تجربة المستخدم، وخاصة عندما يتعلق الأمر بجمع المعلومات. أحد أكثر عناصر النموذج شيوعًا هو زر الاختيار، والذي يسمح للمستخدمين باختيار خيار واحد من مجموعة. في هذا البرنامج التعليمي، سنستكشف كيفية إنشاء أزرار اختيار محاذية أفقيًا ورأسيًا باستخدام Aspose.PDF لـ .NET. سواء كنت مطورًا متمرسًا أو مبتدئًا، سيرشدك هذا الدليل خلال العملية خطوة بخطوة، مما يضمن لك فهمًا واضحًا لكل جزء.

المتطلبات الأساسية

قبل الغوص في الكود، هناك بعض المتطلبات الأساسية التي يجب أن تكون موجودة لديك:

  1. Aspose.PDF لـ .NET: تأكد من تثبيت مكتبة Aspose.PDF. يمكنك تنزيلها منموقع.
  2. Visual Studio: بيئة تطوير يمكنك من خلالها كتابة واختبار الكود الخاص بك.
  3. المعرفة الأساسية بلغة C#: ستساعدك المعرفة ببرمجة C# على فهم مقتطفات التعليمات البرمجية بشكل أفضل.

استيراد الحزم

للبدء، تحتاج إلى استيراد الحزم اللازمة في مشروع C# الخاص بك. إليك كيفية القيام بذلك:

إنشاء مشروع جديد

افتح Visual Studio وأنشئ مشروع C# جديدًا. يمكنك اختيار تطبيق وحدة التحكم لتبسيط الأمر.

إضافة مرجع Aspose.PDF

  1. انقر بزر الماوس الأيمن على مشروعك في مستكشف الحلول.
  2. حدد “إدارة حزم NuGet”.
  3. ابحث عن “Aspose.PDF” وقم بتثبيت الإصدار الأحدث.
using System;
using System.IO;
using Aspose.Pdf.Facades;
using Aspose.Pdf;
using Aspose.Pdf.Forms;

الآن بعد أن قمت بإعداد كل شيء، دعنا نقوم بتقسيم الكود لإنشاء أزرار اختيارية محاذية أفقيًا ورأسيًا.

الخطوة 1: إعداد دليل المستندات

في هذه الخطوة، سنقوم بتحديد المسار إلى الدليل الذي سيتم تخزين مستندات PDF الخاصة بك فيه.

string dataDir = "YOUR DOCUMENT DIRECTORY";

يستبدل"YOUR DOCUMENT DIRECTORY" مع المسار الفعلي الذي تريد حفظ ملف PDF فيه. وهذا أمر بالغ الأهمية لأنه يخبر البرنامج بالمكان الذي يبحث فيه عن ملفات الإدخال والمكان الذي يحفظ فيه الناتج.

الخطوة 2: تحميل مستند PDF الموجود

بعد ذلك، نحتاج إلى تحميل مستند PDF الذي سنعمل عليه. يتم ذلك باستخدامFormEditor فصل.

FormEditor formEditor = new FormEditor();
formEditor.BindPdf(dataDir + "input.pdf");

هنا، نقوم بإنشاء مثيل لـFormEditor وربطه بملف PDF موجود باسمinput.pdfتأكد من وجود هذا الملف في الدليل المحدد.

الخطوة 3: تكوين خصائص زر الاختيار

الآن، دعنا نحدد بعض الخصائص لأزرار الاختيار الخاصة بنا. وهذا يشمل الفجوة بين الأزرار واتجاهها وحجمها.

formEditor.RadioGap = 4; // المسافة بين خيارات أزرار الاختيار
formEditor.RadioHoriz = true; // تم ضبطه على true للمحاذاة الأفقية
formEditor.RadioButtonItemSize = 20; // حجم زر الاختيار
formEditor.Facade.BorderWidth = 1; // عرض الحدود
formEditor.Facade.BorderColor = System.Drawing.Color.Black; // لون الحدود

ستساعدك هذه الخصائص في تحديد كيفية ظهور أزرار الاختيار في ملف PDF.RadioGap تتحكم الخاصية في المسافة بين الأزرار، بينماRadioHoriz يحدد تخطيطهم.

الخطوة 4: إضافة أزرار الاختيار الأفقية

الآن، دعونا نضيف أزرار الراديو الأفقية إلى ملف PDF.

formEditor.Items = new string[] { "First", "Second", "Third" };
formEditor.AddField(FieldType.Radio, "NewField1", 1, 40, 600, 120, 620);

في هذا الكود، نقوم بتعريف العناصر الخاصة بأزرار الاختيار وإضافتها إلى ملف PDF.AddFieldتأخذ الطريقة عدة معلمات، بما في ذلك نوع الحقل، واسم الحقل، وإحداثيات التنسيب.

الخطوة 5: إضافة أزرار راديو عمودية

بعد ذلك، سنضيف أزرار الاختيار العمودية. للقيام بذلك، نحتاج إلى تغيير الاتجاه مرة أخرى إلى الاتجاه العمودي.

formEditor.RadioHoriz = false; // تم ضبطه على خطأ للمحاذاة الرأسية
formEditor.Items = new string[] { "First", "Second", "Third" };
formEditor.AddField(FieldType.Radio, "NewField2", 1, 40, 500, 60, 550);

تمامًا كما في السابق، نقوم بتعريف العناصر وإضافتها إلى ملف PDF، ولكن هذه المرة سيتم محاذاتها عموديًا.

الخطوة 6: احفظ مستند PDF

وأخيرًا، نحتاج إلى حفظ مستند PDF المعدّل.

dataDir = dataDir + "HorizontallyAndVerticallyRadioButtons_out.pdf";
formEditor.Save(dataDir);
Console.WriteLine("\nHorizontally and vertically laid out radio buttons successfully.\nFile saved at " + dataDir);

يحفظ هذا الكود ملف PDF باستخدام أزرار الاختيار المضافة حديثًا. تأكد من التحقق من الدليل المحدد لملف الإخراج.

خاتمة

إن إنشاء أزرار الاختيار في ملف PDF باستخدام Aspose.PDF for .NET عملية بسيطة. باتباع الخطوات الموضحة في هذا البرنامج التعليمي، يمكنك بسهولة إضافة أزرار اختيار محاذية أفقيًا ورأسيًا إلى نماذج PDF الخاصة بك. وهذا لا يعزز التفاعل بين مستنداتك فحسب، بل يحسن أيضًا تجربة المستخدم بشكل عام. لذا، انطلق وجربها!

الأسئلة الشائعة

ما هو Aspose.PDF لـ .NET؟

Aspose.PDF for .NET هي مكتبة قوية تسمح للمطورين بإنشاء مستندات PDF ومعالجتها وتحويلها برمجيًا.

هل يمكنني استخدام Aspose.PDF مجانًا؟

نعم، تقدم Aspose نسخة تجريبية مجانية يمكنك استخدامها لتقييم المكتبة. يمكنك تنزيلهاهنا.

كيف أحصل على الدعم لـ Aspose.PDF؟

يمكنك الحصول على الدعم من خلال زيارةمنتدى اسبوس.

هل من الممكن إنشاء عناصر نموذج أخرى باستخدام Aspose.PDF؟

بالتأكيد! يدعم Aspose.PDF عناصر نموذج مختلفة، بما في ذلك حقول النص ومربعات الاختيار والقوائم المنسدلة.

أين يمكنني شراء Aspose.PDF لـ .NET؟

يمكنك شراء Aspose.PDF لـ .NET منصفحة الشراء.

مربعات الاختيار المجمعة في مستند PDF تعديل حقل النموذج في مستند PDF