إضافة الرؤوس والتذييلات في PDF باستخدام C #

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

سيتم تناول الموضوعات التالية في هذه المقالة:

C # API لإضافة الرؤوس والتذييلات في مستندات PDF

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

Install-Package Aspose.PDF

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

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

  1. أولاً ، قم بتحميل مستند PDF باستخدام فئة Document مع مسار ملف الإدخال كوسيطة. إنها الفئة الرئيسية التي تمثل مستند PDF وتسمح بأداء وظائف مختلفة.
  2. بعد ذلك ، قم بإنشاء مثيل لفئة TextStamp بنص لإظهاره في رأس المستند.
  3. بعد ذلك ، قم بتعيين خصائص مختلفة مثل TopMargin و HorizontalAlignment و VerticalAlignment مثل Top ، إلخ.
  4. اختياريًا ، قم بتعيين ForegroundColor و Font و FontStyle و FontSize و BackgroundColor و RotateAngle و Zoom للنص.
  5. بعد ذلك ، قم بالتكرار خلال جميع الصفحات وإضافة رأس باستخدام طريقة Page.AddStamp () مع كائن TextStamp.
  6. أخيرًا ، قم باستدعاء الأسلوب Document.Save () باستخدام مسار ملف الإخراج كوسيطة لحفظ ملف الإخراج.

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

// يوضح مثال الكود هذا كيفية إضافة نص في رأس مستند PDF موجود.
// قم بتحميل مستند PDF
Document pdfDocument = new Document(@"C:\Files\sample.pdf");

// إنشاء رأس
TextStamp textStamp = new TextStamp("Header Text");

// تعيين خصائص الطابع
textStamp.TopMargin = 10;
textStamp.HorizontalAlignment = HorizontalAlignment.Center;
textStamp.VerticalAlignment = VerticalAlignment.Top;

// حدد نمط الخط
textStamp.TextState.FontStyle = FontStyles.Bold;
textStamp.TextState.ForegroundColor = Color.Red;
textStamp.TextState.FontSize = 14;
textStamp.TextState.BackgroundColor = Color.Pink;
textStamp.TextState.Font = FontRepository.FindFont("Verdana");

// أضف العنوان في جميع الصفحات
foreach (Page page in pdfDocument.Pages)
{
    page.AddStamp(textStamp);
}

// احفظ المستند المحدث
pdfDocument.Save(@"C:\Files\output.pdf");
أضف نصًا في رأس PDF باستخدام C #.

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

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

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

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

// يوضح مثال الكود هذا كيفية إضافة نص في تذييل مستند PDF موجود.
// قم بتحميل مستند PDF
Document pdfDocument = new Document(@"C:\Files\sample.pdf");

// إنشاء تذييل
TextStamp textStamp = new TextStamp("Footer Text");

// تعيين خصائص الطابع
textStamp.BottomMargin = 10;
textStamp.HorizontalAlignment = HorizontalAlignment.Center;
textStamp.VerticalAlignment = VerticalAlignment.Bottom;

// إضافة تذييل في جميع الصفحات
foreach (Page page in pdfDocument.Pages)
{
    page.AddStamp(textStamp);
}

// احفظ المستند المحدث
pdfDocument.Save(@"C:\Files\output.pdf");
أضف نصًا في تذييل ملف PDF باستخدام C #.

أضف نصًا في تذييل ملف PDF باستخدام C #.

إدراج صورة في رأس PDF باستخدام C

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

  1. أولاً ، قم بتحميل مستند PDF باستخدام فئة Document مع مسار ملف الإدخال كوسيطة.
  2. بعد ذلك ، قم بإنشاء مثيل للفئة ImageStamp باستخدام مسار ملف الصورة كوسيطة.
  3. بعد ذلك ، قم بتعيين خصائص مختلفة مثل TopMargin و HorizontalAlignment و VerticalAlignment مثل Top ، إلخ.
  4. بعد ذلك ، قم بالتكرار خلال جميع الصفحات وإضافة رأس باستخدام طريقة Page.AddStamp () مع كائن ImageStamp.
  5. أخيرًا ، قم باستدعاء الأسلوب Document.Save () باستخدام مسار ملف الإخراج كوسيطة لحفظ ملف الإخراج.

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

// يوضح مثال الكود هذا كيفية إضافة صورة في رأس مستند PDF موجود.
// قم بتحميل مستند PDF
Document pdfDocument = new Document(@"C:\Files\sample.pdf");

// إنشاء رأس
ImageStamp imageStamp = new ImageStamp(@"C:\Files\conholdate-logo.jpg");

// تعيين خصائص الطابع
imageStamp.TopMargin = 10;
imageStamp.HorizontalAlignment = HorizontalAlignment.Center;
imageStamp.VerticalAlignment = VerticalAlignment.Top;

// أضف العنوان في جميع الصفحات
foreach (Page page in pdfDocument.Pages)
{
    page.AddStamp(imageStamp);
}

// احفظ المستند المحدث
pdfDocument.Save(@"C:\Files\output.pdf");
قم بإدراج صورة في رأس ملف PDF باستخدام C #.

قم بإدراج صورة في رأس ملف PDF باستخدام C #.

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

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

// يوضح مثال الكود هذا كيفية إضافة صورة في تذييل مستند PDF موجود.
// قم بتحميل مستند PDF
Document pdfDocument = new Document(@"C:\Files\sample.pdf");

// إنشاء تذييل
ImageStamp imageStamp = new ImageStamp(@"C:\Files\conholdate-logo.jpg");

// تعيين خصائص الطابع
imageStamp.BottomMargin = 10;
imageStamp.HorizontalAlignment = HorizontalAlignment.Center;
imageStamp.VerticalAlignment = VerticalAlignment.Bottom;

// إضافة تذييل في جميع الصفحات
foreach (Page page in pdfDocument.Pages)
{
    page.AddStamp(imageStamp);
}

// احفظ المستند المحدث
pdfDocument.Save(@"C:\Files\output.pdf");
إدراج صورة في تذييل ملف PDF باستخدام C #.

إدراج صورة في تذييل ملف PDF باستخدام C #.

إضافة رؤوس وتذييلات مختلفة في صفحات مختلفة

يمكننا إضافة رؤوس / تذييلات مختلفة لصفحات مختلفة في مستند PDF واحد باتباع الخطوات الواردة أدناه:

  1. أولاً ، قم بتحميل مستند PDF باستخدام فئة Document مع مسار ملف الإدخال كوسيطة.
  2. بعد ذلك ، قم بإنشاء مثيلات متعددة للفئة ImageStamp مع مسار ملف الصورة و / أو فئة TextStamp مع نص لإظهاره.
  3. بعد ذلك ، قم بتعيين خصائص مختلفة مثل TopMargin و HorizontalAlignment و VerticalAlignment على أنها Top للرأس و BottomMargin و VerticalAlignment على أنها أسفل للتذييل.
  4. بعد ذلك ، قم بإضافة رأس أو تذييل باستخدام طريقة Page.AddStamp () مع ImageStamp أو كائن TextStamp للصفحة.
  5. أخيرًا ، قم باستدعاء الأسلوب Document.Save () باستخدام مسار ملف الإخراج كوسيطة لحفظ ملف الإخراج.

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

// يوضح مثال الكود هذا كيفية إضافة رؤوس مختلفة لصفحات مختلفة في مستند PDF واحد.
// قم بتحميل مستند PDF
Document pdfDocument = new Document(@"C:\Files\sample.pdf");

// قم بإنشاء ثلاثة طوابع
ImageStamp stamp1 = new ImageStamp(@"C:\Files\PDF\conholdate-logo.jpg");
TextStamp stamp2 = new TextStamp("Header Stamp 2");
TextStamp stamp3 = new TextStamp("Header Stamp 3");

// ضبط محاذاة الطوابع للطابع 1
stamp1.VerticalAlignment = VerticalAlignment.Top;
stamp1.HorizontalAlignment = HorizontalAlignment.Center;

// ضبط محاذاة الطوابع للطابع 2
stamp2.VerticalAlignment = VerticalAlignment.Top;
// قم بتعيين معلومات المحاذاة الأفقية للختم كمحاذاة للوسط
stamp2.HorizontalAlignment = HorizontalAlignment.Center;
// اضبط عامل التكبير لكائن الختم
stamp2.Zoom = 10;

// ضبط محاذاة الطوابع للطابع 3
stamp3.VerticalAlignment = VerticalAlignment.Top;
// قم بتعيين معلومات المحاذاة الأفقية لكائن الطوابع كمحاذة للوسط
stamp3.HorizontalAlignment = HorizontalAlignment.Center;
// اضبط زاوية الدوران لكائن الختم
stamp3.RotateAngle = 35;


// أضف الطابع الأول على الصفحة الأولى ؛
pdfDocument.Pages[1].AddStamp(stamp1);

// أضف طابعًا ثانيًا على الصفحة الثانية ؛
pdfDocument.Pages[2].AddStamp(stamp2);

// أضف الطابع الثالث على الصفحة الثالثة.
pdfDocument.Pages[3].AddStamp(stamp3);

// احفظ المستند المحدث
pdfDocument.Save(@"C:\Files\output.pdf");

أضف أرقام الصفحات في تذييل PDF باستخدام C

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

  1. أولاً ، قم بتحميل مستند PDF باستخدام فئة Document مع مسار ملف الإدخال كوسيطة.
  2. بعد ذلك ، قم بما يلي لكل صفحة في مجموعة Document.Pages.
    • قم بإنشاء مثيل لفئة TextStamp بنص متسلسل مع رقم الصفحة الحالية.
    • بعد ذلك ، قم بتعيين خصائص مختلفة مثل BottomMargin و HorizontalAlignment و VerticalAlignment مثل Bottom ، إلخ.
    • بعد ذلك ، قم باستدعاء الأسلوب Page.AddStamp () باستخدام كائن TextStamp لإضافة رقم الصفحة في التذييل.
  3. أخيرًا ، قم باستدعاء الأسلوب Document.Save () باستخدام مسار ملف الإخراج كوسيطة لحفظ ملف الإخراج.

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

// يوضح مثال الرمز هذا كيفية إضافة رقم الصفحة في تذييل كل صفحة من مستند PDF. 
// قم بتحميل مستند PDF
Document pdfDocument = new Document(@"C:\Files\sample.pdf");

// إضافة تذييل في جميع الصفحات
foreach (Page page in pdfDocument.Pages)
{
    // إنشاء تذييل
    TextStamp textStamp = new TextStamp("Page " + page.Number + " of " + pdfDocument.Pages.Count + " pages.");
    
    // تعيين خصائص الطابع
    textStamp.BottomMargin = 10;
    textStamp.HorizontalAlignment = HorizontalAlignment.Center;
    textStamp.VerticalAlignment = VerticalAlignment.Bottom;

    // أضف طابعًا
    page.AddStamp(textStamp);
}

// احفظ المستند المحدث
pdfDocument.Save(@"C:\Files\PDF\output.pdf");
أضف أرقام الصفحات في التذييل.

أضف أرقام الصفحات في تذييل PDF باستخدام C #.

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

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

استنتاج

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

أنظر أيضا