إضافة الأشكال في مستندات PDF باستخدام C #

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

تتم مناقشة / تغطية الموضوعات التالية في هذه المقالة:

  1. [C # API لرسم الأشكال في مستندات PDF] (# CSharp-API-to-Draw-Shapes-in-PDF-Documents)
  2. [إنشاء مستطيل معبأ في مستندات PDF باستخدام C #] (# Create-Filled-Rectangle-in-PDF-Documents-using-CSharp)
  3. [أضف دائرة في مستندات PDF باستخدام C #] (# Add-Circle-in-PDF-Documents-using-CSharp)
  4. [ارسم خطوطًا عبر الصفحة في مستندات PDF باستخدام C #] (# Draw-Lines-Across-the-Page-in-PDF-Documents-using-CSharp)
  5. [إضافة Ellipse في مستندات PDF باستخدام C #] (# Add-Ellipse-in-PDF-Documents-using-CSharp)

C # API لرسم الأشكال في مستندات PDF

لإضافة الأشكال في ملفات PDF ، سنستخدم Aspose.PDF for .NET API. يتيح لك إنشاء المستندات المدعومة وتعديلها وتحويلها وتقديمها وتأمينها وطباعتها دون استخدام Adobe Acrobat. كما يوفر خيارات الضغط ، وإنشاء الجدول ومعالجته ، ووظائف الرسم البياني والصورة ، ومهام الختم والعلامة المائية ، وعناصر تحكم الأمان الممتدة ، ومعالجة الخطوط المخصصة.

يمكنك إما تنزيل DLL الخاصة بواجهة برمجة التطبيقات أو تثبيته باستخدام NuGet.

Install-Package Aspose.PDF

إنشاء مستطيل معبأ في مستندات PDF باستخدام C

يمكنك إنشاء مستطيل معبأ في مستندات PDF برمجيًا باتباع الخطوات الواردة أدناه:

  • أولاً ، قم بإنشاء مستند جديد باستخدام فئة Document.
  • الآن ، اتصل بالطريقة Document.Pages.Add () لإضافة صفحة فارغة إلى مجموعة صفحات ملف PDF.
  • قم بإنشاء مثيل لفئة Graph بارتفاع وعرض الرسم البياني.
  • ثم ، قم باستدعاء الأسلوب Page.Paragraphs.Add () لإضافة كائن الرسم البياني إلى مجموعة فقرات مثيل الصفحة.
  • الآن ، قم بإنشاء مثيل للفئة Rectangle وقم بتعيين موضعها الأيسر والسفلي ، جنبًا إلى جنب مع العرض والارتفاع.
  • اختياريًا ، حدد لون التعبئة لـ كائن الرسم البياني.
  • ثم أضف كائن المستطيل إلى مجموعة الشكل من كائن الرسم البياني.
  • أخيرًا ، قم باستدعاء الأسلوب Document.Save () مع مسار ملف الإخراج لحفظ الملف.

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

// إنشاء مثيل المستند
Document doc = new Document();

// أضف صفحة إلى مجموعة صفحات من ملف PDF
Page page = doc.Pages.Add();

// إنشاء مثيل الرسم البياني
Graph graph = new Graph(100, 400);

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

// إنشاء مثيل المستطيل
Aspose.Pdf.Drawing.Rectangle rect = new Aspose.Pdf.Drawing.Rectangle(100, 100, 200, 120);

// حدد لون التعبئة لكائن الرسم البياني
rect.GraphInfo.FillColor = Color.Gray;

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

// احفظ ملف PDF
doc.Save(@"C:\Files\PDF\FilledRectangle_out.pdf");
قم بإنشاء مستطيل مملوء في مستندات PDF باستخدام C #.

قم بإنشاء مستطيل مملوء في مستندات PDF باستخدام C #.

أضف دائرة في مستندات PDF باستخدام C

يمكنك إضافة دائرة في مستندات PDF برمجيًا باتباع الخطوات الواردة أدناه:

  • أولاً ، قم بإنشاء مستند جديد باستخدام فئة Document.
  • الآن ، اتصل بالطريقة Document.Pages.Add () لإضافة صفحة فارغة إلى مجموعة صفحات ملف PDF.
  • قم بإنشاء مثيل لفئة Graph بارتفاع وعرض الرسم البياني.
  • ثم ، قم باستدعاء الأسلوب Page.Paragraphs.Add () لإضافة كائن الرسم البياني إلى مجموعة فقرات مثيل الصفحة.
  • الآن ، قم بإنشاء مثيل لفئة Circle وقم بتعيين موضعها X و Y ، جنبًا إلى جنب مع نصف قطرها.
  • ثم ، اضبط اللون ولون التعبئة للدائرة.
  • أضف كائن الدائرة إلى مجموعة الشكل من كائن الرسم البياني.
  • أخيرًا ، قم باستدعاء الأسلوب Document.Save () مع مسار ملف الإخراج لحفظ الملف.

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

// إنشاء مثيل المستند
Document doc = new Document();

// أضف صفحة إلى مجموعة صفحات من ملف PDF
Page page = doc.Pages.Add();

// إنشاء كائن رسومي بأبعاد معينة
Graph graph = new Graph(400, 200);

// إنشاء دائرة
Circle circle = new Circle(100, 100, 40);
circle.GraphInfo.Color = Color.Green;
circle.GraphInfo.FillColor = Color.GreenYellow;

graph.Shapes.Add(circle);

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

// احفظ ملف PDF
doc.Save(@"C:\Files\PDF\FilledCircle_out.pdf");
أضف دائرة في مستندات PDF باستخدام C #.

أضف دائرة في مستندات PDF باستخدام C #.

رسم خطوط عبر الصفحة في مستندات PDF باستخدام C

يمكنك رسم خطوط عبر الصفحة في مستندات PDF برمجيًا باتباع الخطوات الواردة أدناه:

  • أولاً ، قم بإنشاء مستند جديد باستخدام فئة Document.
  • الآن ، اتصل بالطريقة Document.Pages.Add () لإضافة صفحة فارغة إلى مجموعة صفحات ملف PDF.
  • بعد ذلك ، قم بتعيين هوامش الصفحة من جميع الجوانب على 0.
  • قم بإنشاء مثيل لفئة الرسم البياني بعرض الصفحة وارتفاع الصفحة.
  • الآن ، قم بإنشاء مثيل لفئة Line باستخدام مصفوفة موضع الخط لإنشاء سطر يبدأ من الزاوية اليسرى السفلية إلى الزاوية اليمنى العلوية للصفحة.
  • ثم أضف كائن الخط إلى مجموعة الشكل من كائن الرسم البياني.
  • الآن ، قم بإنشاء مثيل آخر لفئة Line باستخدام مصفوفة موضع الخط لرسم خط من الزاوية العلوية اليسرى من الصفحة إلى الزاوية اليمنى السفلية من الصفحة.
  • بعد ذلك ، أضف المثيل الثاني من كائن الخط إلى مجموعة الشكل من كائن الرسم البياني.
  • قم باستدعاء الأسلوب Page.Paragraphs.Add () لإضافة كائن الرسم البياني إلى مجموعة فقرات مثيل الصفحة.
  • أخيرًا ، قم باستدعاء الأسلوب Document.Save () مع مسار ملف الإخراج لحفظ الملف.

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

// إنشاء مثيل المستند
Document doc = new Document();

// أضف صفحة إلى مجموعة صفحات من ملف PDF
Page page = doc.Pages.Add();

// اضبط هامش الصفحة من جميع الجوانب على 0
page.PageInfo.Margin.Left = 0;
page.PageInfo.Margin.Right = 0;
page.PageInfo.Margin.Bottom = 0;
page.PageInfo.Margin.Top = 0;

// قم بإنشاء كائن رسم بياني مع تساوي العرض والارتفاع أبعاد الصفحة
Graph graph = new Graph((float)page.PageInfo.Width, (float)page.PageInfo.Height);

// قم بإنشاء كائن سطر أول بدءًا من الزاوية السفلية اليسرى إلى الزاوية العلوية اليمنى من الصفحة
Line line = new Line(new float[] { (float) page.Rect.LLX, 0, (float) page.PageInfo.Width,
    (float) page.Rect.URY });

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

// ارسم خطًا من الزاوية العلوية اليسرى للصفحة إلى الزاوية اليمنى السفلية للصفحة
Line line2 = new Line(new float[] { 0, (float) page.Rect.URY, (float) page.PageInfo.Width,
    (float) page.Rect.LLX });

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

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

// احفظ ملف PDF
doc.Save(@"C:\Files\PDF\DrawLineAcrossPage_out.pdf");
ارسم خطًا عبر الصفحة في مستندات PDF باستخدام C #.

ارسم خطًا عبر الصفحة في مستندات PDF باستخدام C #.

أضف Ellipse في مستندات PDF باستخدام C

يمكنك إضافة شكل بيضاوي بنص داخل مستندات PDF برمجيًا باتباع الخطوات الواردة أدناه:

  • أولاً ، قم بإنشاء مستند جديد باستخدام فئة Document.
  • الآن ، اتصل بالطريقة Document.Pages.Add () لإضافة صفحة فارغة إلى مجموعة صفحات ملف PDF.
  • قم بإنشاء مثيل لفئة Graph بارتفاع وعرض الرسم البياني.
  • قم بإنشاء مثيل لفئة TextFragment مع القيمة النصية لإظهارها داخل كائن الرسم البياني.
  • ثم قم بتعيين الخط والحجم للنص.
  • الآن ، قم بإنشاء مثيل لفئة Ellipse وقم بتعيين موضعها الأيسر والسفلي ، جنبًا إلى جنب مع عرضها وارتفاعها.
  • بعد ذلك ، قم بتعيين اللون ولون التعبئة وتعيين كائن TextFragment إلى خاصية النص الخاصة به.
  • الآن ، أضف كائن القطع الناقص إلى مجموعة الشكل من كائن الرسم البياني.
  • ثم ، قم باستدعاء الأسلوب Page.Paragraphs.Add () لإضافة كائن الرسم البياني إلى مجموعة فقرات مثيل الصفحة.
  • أخيرًا ، قم باستدعاء الأسلوب Document.Save () مع مسار ملف الإخراج لحفظ الملف.

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

// إنشاء مثيل المستند
Document doc = new Document();

// أضف صفحة إلى مجموعة صفحات من ملف PDF
Page page = doc.Pages.Add();

// إنشاء كائن رسومي بأبعاد معينة
Graph graph = new Graph(400, 400);

// حدد النص
TextFragment textFragment = new TextFragment("Ellipse");
textFragment.TextState.Font = FontRepository.FindFont("Helvetica");
textFragment.TextState.FontSize = 24;

// ارسم القطع الناقص
Ellipse ellipse = new Ellipse(100, 100, 120, 180);
ellipse.GraphInfo.FillColor = Color.GreenYellow;
ellipse.GraphInfo.Color = Color.Red;
ellipse.Text = textFragment;

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

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

// احفظ ملف PDF
doc.Save(@"C:\Files\PDF\EclipseWithText_out.pdf");
أضف Ellipse في مستندات PDF باستخدام C #.

أضف Ellipse في مستندات PDF باستخدام C #.

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

يمكنك تجربة واجهة برمجة التطبيقات بدون قيود التقييم من خلال طلب ترخيص مؤقت مجاني.

استنتاج

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

أنظر أيضا