إضافة نص إلى PDF في C#

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

C# API لإضافة نص إلى PDF

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

PM> Install-Package Aspose.PDF

إضافة نص إلى ملف PDF باستخدام C#

فيما يلي خطوات إضافة نص إلى ملف PDF باستخدام C#.

  • قم بتحميل ملف PDF باستخدام فئة المستند.
  • احصل على الصفحة المطلوبة من ملف PDF في كائن صفحة.
  • قم بإنشاء كائن TextFragment واضبط النص ، والموضع ، والخط ، ولون الخلفية ، وما إلى ذلك.
  • قم بإنشاء كائن TextBuilder وقم بتهيئته باستخدام كائن الصفحة.
  • استخدم طريقة TextBuilder.AppendText (TextFragment) لإضافة نص إلى صفحة PDF.
  • احفظ ملف PDF المحدث باستخدام طريقة Document.Save(String).

يوضح نموذج التعليمات البرمجية التالي كيفية إضافة نص إلى ملف PDF.

// للحصول على أمثلة وملفات بيانات كاملة ، يرجى الانتقال إلى https://github.com/aspose-pdf/Aspose.PDF-for-.NET
// افتح المستند
Document pdfDocument = new Document("input.pdf");

// احصل على صفحة معينة
Page pdfPage = (Page)pdfDocument.Pages[1];

// إنشاء جزء من النص
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.FromRgb(System.Drawing.Color.LightGray);
textFragment.TextState.ForegroundColor = Aspose.Pdf.Color.FromRgb(System.Drawing.Color.Red);

// إنشاء كائن TextBuilder
TextBuilder textBuilder = new TextBuilder(pdfPage);

// قم بإلحاق جزء النص بصفحة PDF
textBuilder.AppendText(textFragment);

// حفظ مستند PDF الناتج.
pdfDocument.Save("output.pdf");

أضف نصًا إلى PDF باستخدام TextParagraph

فيما يلي خطوات إضافة نص إلى ملف PDF باستخدام TextParagraph.

  • قم بتحميل ملف PDF باستخدام فئة المستند.
  • احصل على الصفحة المطلوبة من PDF في كائن صفحة أو أضف كائنًا جديدًا.
  • قم بإنشاء كائن TextBuilder وقم بتهيئته باستخدام كائن الصفحة.
  • قم بإنشاء كائن من فئة TextParagraph.
  • حدد موقع الفقرة باستخدام خاصية TextParagraph.Rectangle.
  • قم بتعيين خيارات التنسيق الخاصة بـ TextParagraph.
  • قم بإنشاء كائن TextFragment وقم بتعيين النص ، والموضع ، والخط ، ولون الخلفية ، وما إلى ذلك.
  • أضف جزء النص إلى الفقرة باستخدام أسلوب TextParagraph.AppendLine (TextFragment).
  • أضف فقرة إلى الصفحة باستخدام طريقة TextBuilder.AppendParagraph (TextParagraph).
  • احفظ ملف PDF المحدث باستخدام طريقة Document.Save(String).

يوضح نموذج التعليمات البرمجية التالي كيفية إضافة نص إلى ملف PDF باستخدام فئة TextParagraph.

// للحصول على أمثلة وملفات بيانات كاملة ، يرجى الانتقال إلى https://github.com/aspose-pdf/Aspose.PDF-for-.NET
string fontFile = "font.ttf";

// قم بتحميل ملف PDF للإدخال
Document doc = new Document("input.pdf");

// إنشاء كائن منشئ النص للصفحة الأولى من المستند
TextBuilder textBuilder = new TextBuilder(doc.Pages[1]);

// إنشاء جزء نصي مع سلسلة عينة
TextFragment textFragment = new TextFragment("Hello world");

if (fontFile != "")
{
    // قم بتحميل خط تروتايب إلى كائن دفق
    using (FileStream fontStream = File.OpenRead(fontFile))
    {
        // قم بتعيين اسم الخط للسلسلة النصية
        textFragment.TextState.Font = FontRepository.OpenFont(fontStream, FontTypes.TTF);
        
        // حدد موضع جزء النص
        textFragment.Position = new Position(10, 10);
        
        // أضف النص إلى TextBuilder بحيث يمكن وضعه فوق ملف PDF
        textBuilder.AppendText(textFragment);
    }

    // حفظ مستند PDF الناتج
    doc.Save("output.pdf");
}

أضف نصًا شفافًا في PDF في C#

يسمح Aspose.PDF for .NET أيضًا بإضافة نص شفاف إلى مستند PDF ، كما هو موضح في الخطوات التالية.

يوضح نموذج التعليمات البرمجية التالي كيفية إضافة نص شفاف إلى ملف PDF.

// للحصول على أمثلة وملفات بيانات كاملة ، يرجى الانتقال إلى https://github.com/aspose-pdf/Aspose.PDF-for-.NET
// إنشاء مثيل المستند
Document doc = new Document("input.pdf");

// إنشاء صفحة لمجموعة صفحات من ملف PDF
Aspose.Pdf.Page page = doc.Pages.Add();

// إنشاء كائن الرسم البياني
Aspose.Pdf.Drawing.Graph canvas = new Aspose.Pdf.Drawing.Graph(100, 400);

// إنشاء مثيل مستطيل بأبعاد معينة
Aspose.Pdf.Drawing.Rectangle rect = new Aspose.Pdf.Drawing.Rectangle(100, 100, 400, 400);

// قم بإنشاء كائن لون من قناة ألوان ألفا
rect.GraphInfo.FillColor = Aspose.Pdf.Color.FromRgb(System.Drawing.Color.FromArgb(128, System.Drawing.Color.FromArgb(12957183)));

// أضف المستطيل إلى مجموعة الأشكال لكائن الرسم البياني
canvas.Shapes.Add(rect);

// أضف كائن الرسم البياني إلى مجموعة فقرات كائن الصفحة
page.Paragraphs.Add(canvas);

// قم بتعيين القيمة على عدم تغيير موضع كائن الرسم البياني
canvas.IsChangePosition = false;

// إنشاء مثيل TextFragment مع قيمة العينة
TextFragment text = new TextFragment("transparent text transparent text transparent text transparent text transparent text transparent text transparent text transparent text transparent text transparent text transparent text transparent text transparent text transparent text transparent text transparent text ");

// إنشاء كائن لون من قناة ألفا
Aspose.Pdf.Color color = Aspose.Pdf.Color.FromArgb(30, 0, 255, 0);

// تعيين معلومات اللون لمثيل النص
text.TextState.ForegroundColor = color;

// إضافة نص إلى مجموعة فقرات نسخة الصفحة
page.Paragraphs.Add(text);

// احفظ ملف PDF المحدث
doc.Save("output.pdf");

احصل على رخصة مجانية

يمكنك استخدام Aspose.PDF for .NET بدون قيود تقييمية باستخدام ترخيص مؤقت.

استنتاج

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

أنظر أيضا