تدوير النص داخل مستندات PDF في C#

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

C# .NET API لتدوير النص في PDF

Aspose.PDF for .NET هي مكتبة من فئة C# توفر ميزات معالجة أساسية ومتقدمة لملفات PDF لتطبيقات .NET. باستخدام API ، يمكنك إنشاء مستندات PDF بتخطيطات بسيطة أو معقدة بسلاسة. سنستخدم واجهة برمجة التطبيقات هذه لتدوير النص داخل مستندات PDF. يمكنك إما تنزيل DLL الخاصة بواجهة برمجة التطبيقات أو تثبيته باستخدام NuGet.

PM> Install-Package Aspose.PDF

تدوير النص داخل PDF في C#

هناك عدة طرق لتدوير نص داخل مستند PDF. يمكنك إما تدوير جزء نصي أو فقرة كاملة. دعونا نرى كيف يعمل كل من هذه التدويرات النصية.

استدارة نص PDF باستخدام TextFragment في C#

فيما يلي خطوات تدوير جزء نصي في مستند PDF باستخدام C#.

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

يوضح نموذج التعليمات البرمجية التالي كيفية تدوير النص في مستند PDF في C#.

// تهيئة كائن المستند
Document pdfDocument = new Document();
            
// احصل على صفحة معينة
var pdfPage = pdfDocument.Pages.Add();
            
// إنشاء جزء من النص
TextFragment textFragment1 = new TextFragment("main text");
textFragment1.Position = new Position(100, 600);
            
// تعيين خصائص النص
textFragment1.TextState.FontSize = 12;
textFragment1.TextState.Font = FontRepository.FindFont("TimesNewRoman");
            
// إنشاء جزء نص مستدير
TextFragment textFragment2 = new TextFragment("rotated text");
textFragment2.Position = new Position(200, 600);
            
// تعيين خصائص النص
textFragment2.TextState.FontSize = 12;
textFragment2.TextState.Font = FontRepository.FindFont("TimesNewRoman");
textFragment2.TextState.Rotation = 45;
            
// إنشاء جزء نص مستدير
TextFragment textFragment3 = new TextFragment("rotated text");
textFragment3.Position = new Position(300, 600);
            
// تعيين خصائص النص
textFragment3.TextState.FontSize = 12;
textFragment3.TextState.Font = FontRepository.FindFont("TimesNewRoman");
textFragment3.TextState.Rotation = 90;
            
// إنشاء كائن TextBuilder
TextBuilder textBuilder = new TextBuilder(pdfPage);
            
// قم بإلحاق جزء النص بصفحة PDF
textBuilder.AppendText(textFragment1);
textBuilder.AppendText(textFragment2);
textBuilder.AppendText(textFragment3);
            
// احفظ المستند
pdfDocument.Save("Rotation_TextFragment.pdf");

انتاج |

استدارة نص PDF باستخدام TextFragment في C#

استدارة نص PDF باستخدام TextParagraph في C#

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

يوضح نموذج التعليمات البرمجية التالي كيفية تدوير النص داخل فقرة في PDF برمجيًا.

// تهيئة كائن المستند
Document pdfDocument = new Document();
           
// احصل على صفحة معينة
var pdfPage = pdfDocument.Pages.Add();
TextParagraph paragraph = new TextParagraph();
paragraph.Position = new Position(200, 600);
            
// إنشاء جزء من النص
TextFragment textFragment1 = new TextFragment("rotated text");
            
// تعيين خصائص النص
textFragment1.TextState.FontSize = 12;
textFragment1.TextState.Font = FontRepository.FindFont("TimesNewRoman");
            
// تعيين التناوب
textFragment1.TextState.Rotation = 45;
            
// إنشاء جزء من النص
TextFragment textFragment2 = new TextFragment("main text");
            
// تعيين خصائص النص
textFragment2.TextState.FontSize = 12;
textFragment2.TextState.Font = FontRepository.FindFont("TimesNewRoman");
            
// إنشاء جزء من النص
TextFragment textFragment3 = new TextFragment("another rotated text");
            
// تعيين خصائص النص
textFragment3.TextState.FontSize = 12;
textFragment3.TextState.Font = FontRepository.FindFont("TimesNewRoman");
            
// تعيين التناوب
textFragment3.TextState.Rotation = -45;
            
// إلحاق أجزاء النص بالفقرة
paragraph.AppendLine(textFragment1);
paragraph.AppendLine(textFragment2);
paragraph.AppendLine(textFragment3);
            
// إنشاء كائن TextBuilder
TextBuilder textBuilder = new TextBuilder(pdfPage);
            
// قم بإلحاق فقرة النص بصفحة PDF
textBuilder.AppendParagraph(paragraph);

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

انتاج |

استدارة نص PDF باستخدام TextParagraph في C#

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

يمكنك تجربة Aspose.PDF for .NET مجانًا من خلال الحصول على ترخيص مؤقت.

استنتاج

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

أنظر أيضا