إضافة حدود النص في ملف PDF
سيرشدك هذا البرنامج التعليمي خلال عملية إضافة حد نص في ملف PDF باستخدام Aspose.PDF لـ .NET. يوضح كود مصدر C# المقدم الخطوات اللازمة.
متطلبات
قبل أن تبدأ، تأكد من أن لديك ما يلي:
- Visual Studio أو أي مترجم C# آخر مثبت على جهازك.
- Aspose.PDF لمكتبة .NET. يمكنك تنزيله من موقع Aspose الرسمي أو استخدام مدير الحزم مثل NuGet لتثبيته.
الخطوة 1: إعداد المشروع
- قم بإنشاء مشروع C# جديد في بيئة التطوير المفضلة لديك.
- قم بإضافة مرجع إلى Aspose.PDF لمكتبة .NET.
الخطوة 2: استيراد مساحات الأسماء المطلوبة
في ملف التعليمات البرمجية الذي تريد إضافة حد النص إليه، أضف ما يلي باستخدام التوجيه في أعلى الملف:
using Aspose.Pdf;
using Aspose.Pdf.Text;
الخطوة 3: قم بتعيين دليل المستند
في الكود، حدد السطر الذي يقولstring dataDir = "YOUR DOCUMENT DIRECTORY"; واستبدال"YOUR DOCUMENT DIRECTORY" مع المسار إلى الدليل حيث يتم تخزين المستندات الخاصة بك.
الخطوة 4: إنشاء كائن مستند جديد
إنشاء مثيل جديدDocument كائن عن طريق إضافة السطر التالي من التعليمات البرمجية:
Document pdfDocument = new Document();
الخطوة 5: إضافة صفحة إلى المستند
أضف صفحة جديدة إلى المستند باستخدامAdd طريقةPagesمجموعة. في الكود المقدم، يتم تعيين الصفحة الجديدة للمتغيرpdfPage.
Page pdfPage = (Page)pdfDocument.Pages.Add();
الخطوة 6: إنشاء TextFragment
إنشاءTextFragment الكائن وتقديم النص المطلوب. اضبط موضع جزء النص باستخدامPosition ملكية. في الكود المقدم، تم تعيين النص على “النص الرئيسي” ووضعه عند (100، 600) على الصفحة.
TextFragment textFragment = new TextFragment("main text");
textFragment.Position = new Position(100, 600);
الخطوة 7: تعيين خصائص النص
قم بتخصيص خصائص النص مثل حجم الخط ونوع الخط ولون الخلفية ولون المقدمة وما إلى ذلك. في التعليمات البرمجية المتوفرة، يتم تعيين خصائص مثل حجم الخط والخط ولون الخلفية ولون المقدمة ولون التمسيد لجزء النص.
textFragment.TextState.FontSize = 12;
textFragment.TextState.Font = FontRepository.FindFont("TimesNewRoman");
textFragment.TextState.BackgroundColor = Aspose.Pdf.Color.LightGray;
textFragment.TextState.ForegroundColor = Aspose.Pdf.Color.Red;
textFragment.TextState.StrokingColor = Aspose.Pdf.Color.DarkRed;
الخطوة 8: تمكين حدود النص
لتمكين حدود النص، قم بتعيينDrawTextRectangleBorderخاصية جزء النصTextState لtrue.
textFragment.TextState.DrawTextRectangleBorder = true;
الخطوة 9: أضف TextFragment إلى الصفحة
استخدم الTextBuilder فئة لإضافةTextFragment الاعتراض على الصفحة.
TextBuilder tb = new TextBuilder(pdfPage);
tb.AppendText(textFragment);
الخطوة 10: احفظ مستند PDF
احفظ مستند PDF باستخدامSave طريقةDocument هدف. حدد مسار ملف الإخراج الذي قمت بتعيينه في الخطوة 3.
pdfDocument.Save(dataDir + "PDFWithTextBorder_out.pdf");
نموذج التعليمات البرمجية المصدر لإضافة حدود النص باستخدام Aspose.PDF لـ .NET
// المسار إلى دليل المستندات.
string dataDir = "YOUR DOCUMENT DIRECTORY";
// إنشاء كائن مستند جديد
Document pdfDocument = new Document();
// الحصول على صفحة معينة
Page pdfPage = (Page)pdfDocument.Pages.Add();
// إنشاء جزء من النص
TextFragment textFragment = new TextFragment("main text");
textFragment.Position = new Position(100, 600);
// تعيين خصائص النص
textFragment.TextState.FontSize = 12;
textFragment.TextState.Font = FontRepository.FindFont("TimesNewRoman");
textFragment.TextState.BackgroundColor = Aspose.Pdf.Color.LightGray;
textFragment.TextState.ForegroundColor = Aspose.Pdf.Color.Red;
// قم بتعيين خاصية StrokingColor لرسم الحدود (التمسيد) حول مستطيل النص
textFragment.TextState.StrokingColor = Aspose.Pdf.Color.DarkRed;
// قم بتعيين قيمة الخاصية DrawTextRectangleBorder إلى true
textFragment.TextState.DrawTextRectangleBorder = true;
TextBuilder tb = new TextBuilder(pdfPage);
tb.AppendText(textFragment);
// احفظ المستند
pdfDocument.Save(dataDir + "PDFWithTextBorder_out.pdf");
خاتمة
لقد نجحت في إضافة حد نص إلى مستند PDF الخاص بك باستخدام Aspose.PDF لـ .NET. يمكن الآن العثور على ملف PDF الناتج في مسار ملف الإخراج المحدد.
الأسئلة الشائعة
س: ما هو التركيز الرئيسي لهذا البرنامج التعليمي؟
ج: يرشدك هذا البرنامج التعليمي خلال عملية إضافة حد نص إلى ملف PDF باستخدام مكتبة Aspose.PDF لـ .NET. يوضح كود مصدر C# المقدم الخطوات اللازمة لتحقيق ذلك.
س: ما هي مساحات الأسماء التي أحتاج إلى استيرادها لهذا البرنامج التعليمي؟
ج: في ملف التعليمات البرمجية الذي تريد إضافة حد النص إليه، قم باستيراد مساحات الأسماء التالية في بداية الملف:
using Aspose.Pdf;
using Aspose.Pdf.Text;
س: كيف أحدد دليل المستندات؟
ج: في الكود، حدد موقع السطرstring dataDir = "YOUR DOCUMENT DIRECTORY"; واستبدال"YOUR DOCUMENT DIRECTORY" بالمسار الفعلي إلى دليل المستندات الخاص بك.
س: كيف أقوم بإنشاء كائن مستند؟
ج: في الخطوة 4، ستقوم بإنشاء نسخة جديدةDocument كائن باستخدام السطر التالي من التعليمات البرمجية:
Document pdfDocument = new Document();
س: كيف يمكنني إضافة صفحة إلى المستند؟
ج: في الخطوة 5، ستضيف صفحة جديدة إلى المستند باستخدام الملفAdd طريقةPages مجموعة:
Page pdfPage = (Page)pdfDocument.Pages.Add();
س: كيف يمكنني إنشاء TextFragment وتعيين موضعه؟
ج: في الخطوة 6، ستقوم بإنشاء ملفTextFragmentكائن وتعيين موضعه على الصفحة باستخدامPosition ملكية:
TextFragment textFragment = new TextFragment("main text");
textFragment.Position = new Position(100, 600);
س: كيف يمكنني تخصيص خصائص النص، بما في ذلك حدود النص؟
ج: في الخطوة 7، ستقوم بتخصيص خصائص النص المختلفة مثل حجم الخط ونوع الخط ولون الخلفية ولون المقدمة وحدود النص:
textFragment.TextState.FontSize = 12;
textFragment.TextState.Font = FontRepository.FindFont("TimesNewRoman");
textFragment.TextState.BackgroundColor = Aspose.Pdf.Color.LightGray;
textFragment.TextState.ForegroundColor = Aspose.Pdf.Color.Red;
textFragment.TextState.StrokingColor = Aspose.Pdf.Color.DarkRed;
textFragment.TextState.DrawTextRectangleBorder = true;
س: كيف يمكنني إضافة TextFragment إلى مستند PDF؟
ج: في الخطوة 9، ستستخدمTextBuilder فئة لإضافةTextFragment الاعتراض على الصفحة:
TextBuilder tb = new TextBuilder(pdfPage);
tb.AppendText(textFragment);
س: كيف يمكنني حفظ مستند PDF الناتج؟
ج: بعد إضافة النص بحدود، استخدمSave طريقةDocument كائن لحفظ مستند PDF:
pdfDocument.Save(dataDir + "PDFWithTextBorder_out.pdf");
س: ما هي الوجبات الرئيسية من هذا البرنامج التعليمي؟
ج: باتباع هذا البرنامج التعليمي، تكون قد تعلمت بنجاح كيفية تحسين مستند PDF الخاص بك عن طريق إضافة حد نص باستخدام Aspose.PDF لـ .NET. يمكن أن يكون هذا مفيدًا بشكل خاص للتأكيد على محتوى نصي محدد داخل ملفات PDF الخاصة بك.
