Documentation – فئة ختم ملفات PDF

Python-Net: إضافة تذييل إلى PDF

Thu, 11 Jun 2026 00:00:00 +0000

يوفر Aspose.PDF لبيثون عبر .NET طابع ملف PDF واجهة لإضافة محتوى متكرر إلى صفحات PDF. يمكنك استخدامه لوضع نص التذييل أو الصور في أسفل كل صفحة وضبط هوامش التذييل للتحكم في الموضع.

إضافة تذييل نصي

استخدم add_footer() مع FormattedText الكائن عندما تريد وضع نفس تذييل النص على كل صفحة من صفحات PDF. تقوم الوسيطة الثانية بتعيين الهامش السفلي المستخدم لوضع التذييل.

import sys
from os import path
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def add_text_footer(infile: str, outfile: str) -> None:
    """Add a text footer with a bottom margin."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        text = pdf_facades.FormattedText("Sample Footer")
        pdf_stamper.add_footer(text, 20)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

إضافة تذييل صورة

استخدم add_footer() مع دفق الصور عندما يجب أن يعرض التذييل شعارًا أو صورة أخرى بدلاً من النص. يفتح المثال ملف الصورة كتدفق ثنائي ويضعه في أسفل كل صفحة.

import sys
from os import path
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def add_image_footer(infile: str, image_file: str, outfile: str) -> None:
    """Add an image footer with a bottom margin."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        pdf_stamper.add_footer(image_file, 20)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

إضافة تذييل بهوامش مخصصة

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

import sys
from os import path
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def add_footer_with_margins(infile: str, outfile: str) -> None:
    """Add a text footer with bottom, left, and right margins."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        text = pdf_facades.FormattedText("This footer has margins on all sides.")
        pdf_stamper.add_footer(text, 20, 20, 20)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Python-Net: إضافة رأس إلى PDF

Thu, 11 Jun 2026 00:00:00 +0000

يوفر Aspose.PDF لبيثون عبر .NET طابع ملف PDF واجهة لإضافة محتوى متكرر إلى صفحات PDF. يمكنك استخدامه لوضع نص العنوان أو الصور في أعلى كل صفحة وضبط هوامش العنوان للتحكم في الموضع.

إضافة رأس نص

استخدم add_header() مع FormattedText الكائن عندما تريد وضع نفس نص العنوان على كل صفحة من صفحات PDF. تحدد الوسيطة الثانية الهامش العلوي للرأس.

import sys
from os import path

import aspose.pydrawing as ap_pydrawing
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def add_text_header(infile: str, outfile: str) -> None:
    """Add a text header with a top margin."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        text = pdf_facades.FormattedText("Sample Header")
        pdf_stamper.add_header(text, 20)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

إضافة رأس صورة

استخدم add_header() مع ملف صورة أو دفق صور عندما يجب أن يعرض العنوان شعارًا أو رسمًا آخر. هذا مفيد لتخطيطات المستندات ذات العلامات التجارية.

import sys
from os import path

import aspose.pydrawing as ap_pydrawing
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def add_image_header(infile: str, image_file: str, outfile: str) -> None:
    """Add an image header with a top margin."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        pdf_stamper.add_header(image_file, 20)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

إضافة عنوان بهوامش مخصصة

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

import sys
from os import path

import aspose.pydrawing as ap_pydrawing
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def add_header_with_margins(infile: str, outfile: str) -> None:
    """Add a text header with top, left, and right margins."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        text = pdf_facades.FormattedText(
            text="Sample Header",
            text_color=ap_pydrawing.Color.blue,
            font_name="Arial",
            text_encoding=pdf_facades.EncodingType.WINANSI,
            embedded=True,
            font_size=12.0,
        )
        pdf_stamper.add_header(text, 20, 20, 20)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Python-Net: إضافة رقم الصفحة إلى PDF

Thu, 11 Jun 2026 00:00:00 +0000

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

إضافة أرقام الصفحات بالموضع الافتراضي

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

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def add_page_numbers_default(infile: str, outfile: str) -> None:
    """Add centered page numbers to the bottom of each page."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        pdf_stamper.add_page_number("Page #")
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

إضافة أرقام الصفحات في الإحداثيات المخصصة

استخدم التحميل الزائد المستند إلى الإحداثيات عندما تحتاج إلى ظهور أرقام الصفحات في موضع X و Y محدد في كل صفحة. يكون هذا الأسلوب مفيدًا عندما يتطلب تخطيط المستند موضعًا مخصصًا.

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def add_page_numbers_at_coordinates(infile: str, outfile: str) -> None:
    """Add page numbers at explicit X/Y coordinates."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        pdf_stamper.add_page_number("Page #", 300, 20)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

إضافة أرقام الصفحات مع المحاذاة والهوامش

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

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def add_page_numbers_with_position_and_margins(infile: str, outfile: str) -> None:
    """Add page numbers using a predefined position and page margins."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        pdf_stamper.add_page_number(
            "Page #",
            pdf_facades.PdfFileStamp.POS_BOTTOM_RIGHT,
            10,
            10,
            10,
            10,
        )
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

إضافة أرقام الصفحات بالنمط الروماني

تُظهر وظيفة «add_page_numbers_with_roman_style» كيفية تحسين مستند PDF عن طريق إضافة أرقام الصفحات باستخدام الأرقام الرومانية الكبيرة. إنه يستفيد من فئة PDFfileStamp من Aspose.PDF لتطبيق الترقيم المتسق عبر جميع الصفحات.

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def add_page_numbers_with_roman_style(infile: str, outfile: str) -> None:
    """Add page numbers with a custom start value and Roman numbering."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        pdf_stamper.numbering_style = ap.NumberingStyle.NUMERALS_ROMAN_UPPERCASE
        pdf_stamper.starting_number = 42
        pdf_stamper.add_page_number("Page #", pdf_facades.PdfFileStamp.POS_UPPER_RIGHT)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Python-Net: إضافة ختم إلى PDF

Thu, 11 Jun 2026 00:00:00 +0000

يوفر Aspose.PDF لبيثون عبر .NET طابع ملف PDF واجهة لإضافة محتوى متكرر إلى صفحات PDF. بالإضافة إلى الرؤوس والتذييلات وأرقام الصفحات، يمكنك استخدامها لوضع طوابع نصية على كل صفحة من صفحات المستند.

أضف الطابع إلى PDF

بعد تكوين الختم، قم بربط ملف PDF المدخل بـ PdfFileStampوأضف الطابع واحفظ ملف الإخراج. يقوم هذا بتطبيق الطابع الذي تم تكوينه عبر المستند.

import sys
from os import path

import aspose.pdf.facades as pdf_facades

CURRENT_DIR = path.dirname(__file__)
EXAMPLES_DIR = path.abspath(path.join(CURRENT_DIR, "..", ".."))
if EXAMPLES_DIR not in sys.path:
    sys.path.insert(0, EXAMPLES_DIR)

from config import initialize_data_dir, set_license


def add_stamp_to_pdf(infile: str, image_file: str, outfile: str) -> None:
    """Add an image stamp to a PDF file."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)

        stamp = pdf_facades.Stamp()
        stamp.bind_image(image_file)

        pdf_stamper.add_stamp(stamp)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()