Documentation – العمل مع واجهات PDF

Python-Net: فئة محرر ملفات PDF

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

يتضمن العمل مع مستندات PDF وظائف مختلفة. تعد إدارة صفحات ملف PDF جزءًا مهمًا من هذه المهمة. يوفر «aspose.pdf.facades» PdfFileEditor فئة لهذا الغرض.

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

ما يمكنك القيام به باستخدام محرر ملفات PDF

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

دروس محرر ملفات PDF

Python-Net: فئة محرر محتوى PDF

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

ال PdfContentEditor تم تصميم الفصل الدراسي في Aspose.PDF Scades لمهام التحرير على مستوى المحتوى في مستندات PDF الحالية. يوفر واجهة برمجة تطبيقات مبسطة لتحديث العناصر التفاعلية، واستبدال النص، والعمل مع المرفقات والروابط، وضبط سلوك المستند في Python عبر تطبيقات.NET.

ما يمكنك القيام به باستخدام محرر محتوى PDF

استخدم هذا القسم لاستكشاف المجالات الرئيسية لتحرير محتوى PDF بدعم من PdfContentEditor الواجهة:

Python-Net: فئة محرر التعليقات التوضيحية لـ PDF

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

ال PdfAnnotationEditor تم تصميم class in Aspose.PDF Scades للعمل مع التعليقات التوضيحية لـ PDF والترميز المستند إلى التعليقات دون تحرير البنية ذات المستوى المنخفض للمستند يدويًا. يوفر طريقة مبسطة للتعامل مع عمليات سير عمل التعليقات التوضيحية في Python عبر .NET عندما تحتاج إلى فحص ملفات PDF الموجودة أو تحديثها.

ما الغرض من استخدام محرر التعليق التوضيحي لـ PDFannotation

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

Python-Net: فئة توقيع ملف PDF

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

إعداد مساعدي التوقيع الرقمي بصيغة PDF

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

ما يحققه هذا الإعداد

تقوم هذه الطبقة المساعدة بإعداد كل ما يلزم لسير عمل التوقيع السلس:

يقوم بتهيئة كائن PDFfileSignature ويربطه بمستند
يحدد المكان الذي سيظهر فيه التوقيع على الصفحة
يقوم بتحميل وتطبيق شهادة التوقيع
يقوم بإنشاء كائن توقيع PKCS #7 قابل لإعادة الاستخدام مع البيانات الوصفية
يقوم بتخصيص كيفية ظهور التوقيع بشكل مرئي

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


DEFAULT_CERTIFICATE_PASSWORD = "Aspose2021"
DEFAULT_SIGNATURE_NAME = "Signature1"


def create_pdf_file_signature(infile):
    pdf_signature = pdf_facades.PdfFileSignature()
    pdf_signature.bind_pdf(infile)
    return pdf_signature


def create_signature_rectangle():
    return apd.Rectangle(10, 10, 200, 60)


def configure_signature_certificate(
    pdf_signature, certificate_path, certificate_password=DEFAULT_CERTIFICATE_PASSWORD
):
    pdf_signature.set_certificate(certificate_path, certificate_password)


def create_pkcs7_signature(
    certificate_path, certificate_password=DEFAULT_CERTIFICATE_PASSWORD
):
    signature = ap.forms.PKCS7(certificate_path, certificate_password)
    signature.reason = "Document approval"
    signature.contact_info = "qa@example.com"
    signature.location = "New York, USA"
    signature.authority = "Aspose.PDF Example"
    return signature


def create_custom_signature_appearance():
    appearance = ap.forms.SignatureCustomAppearance()
    appearance.font_family_name = "Arial"
    appearance.font_size = 10
    appearance.show_contact_info = True
    appearance.show_location = True
    appearance.show_reason = True
    return appearance

Python-Net: فئة فورميديتور

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

ال FormEditor تم تصميم الفصل الدراسي في Aspose.PDF للواجهات لإنشاء وتحديث حقول نماذج PDF التفاعلية. يساعدك على إنشاء هياكل النماذج وضبط خصائص الحقل وتغيير إعدادات المظهر وإرفاق السلوك التفاعلي مثل البرامج النصية وإرسال الإجراءات في تطبيقات Python.

مهام ForMeditor الشائعة

استخدم البرامج التعليمية التالية للعمل مع الإمكانات الرئيسية لـ FormEditor الواجهة:

Python-Net: فئة معلومات ملف PDF

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

ال PdfFileInfo توفر الفئة في Aspose.PDF facades الوصول إلى معلومات PDF على مستوى المستند ومستوى الصفحة دون الحاجة إلى تحليل منخفض المستوى. يكون مفيدًا عندما تحتاج إلى فحص البيانات الأولية أو استرداد خصائص المستند أو التحقق من الامتيازات أو فحص أبعاد الصفحة والإزاحات في عمليات سير العمل التلقائية.

ما يمكنك القيام به مع PDFfileInfo

استخدم المقالات الموجودة في هذا القسم لاستكشاف إمكانيات فحص الملفات الرئيسية لـ PdfFileInfo الواجهة:

Python-Net: فئة أمان ملفات PDF

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

ال PdfFileSecurity يتم استخدام class in Aspose.PDF Faaces لحماية مستندات PDF والتحكم في كيفية تفاعل المستخدمين معها. وهو يدعم عمليات سير عمل الأمان الشائعة مثل التشفير المستند إلى كلمة المرور وفك التشفير وتدوير كلمة المرور وإدارة الأذونات للطباعة والنسخ والتحرير.

ما يمكنك القيام به باستخدام أمان ملفات PDF

استخدم المقالات الموجودة في هذا القسم لاستكشاف مهام أمان PDF الرئيسية التي يدعمها PdfFileSecurity الواجهة:

Python-Net: فئة عارض ملفات PDF

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

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

قم بإنشاء مساعد PDFViewer قابل لإعادة الاستخدام

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

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


def _create_viewer() -> pdf_facades.PdfViewer:
    """Create a PdfViewer configured for decoding examples."""
    viewer = pdf_facades.PdfViewer()
    viewer.coordinate_type = ap.PageCoordinateType.MEDIA_BOX
    viewer.resolution = 150
    viewer.scale_factor = 1.0
    viewer.show_hidden_areas = False
    return viewer

فك شفرة جميع صفحات PDF

استخدم decode_all_pages() عندما تريد تحويل كل صفحة في 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 decode_all_pages(infile: str, output_dir: str) -> None:
    """Decode all pages of a PDF document into image files."""
    viewer = _create_viewer()
    try:
        viewer.open_pdf_file(infile)
        decoded_pages = viewer.decode_all_pages()

        for index, page_image in enumerate(decoded_pages, start=1):
            image_path = path.join(output_dir, f"decode_all_pages_{index}.png")
            page_image.save(image_path)
    finally:
        viewer.close_pdf_file()

فك شفرة صفحة PDF محددة

استخدم decode_page() عندما تحتاج إلى صفحة واحدة فقط من المستند. يكون هذا مفيدًا عند إنشاء معاينات أو صور مصغرة أو عمليات تصدير خاصة بالصفحة.

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 decode_specific_page(infile: str, outfile: str, page_number: int = 1) -> None:
    """Decode a specific PDF page into an image file."""
    viewer = _create_viewer()
    try:
        viewer.bind_pdf(infile)
        page_image = viewer.decode_page(page_number)
        page_image.save(outfile)

    finally:
        viewer.close()

افحص بيانات PDF الوصفية

ال inspect_pdf_metadata توضح الوظيفة كيفية فتح مستند PDF واسترداد البيانات الوصفية الأساسية المتعلقة بالعارض باستخدام 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 inspect_pdf_metadata(infile: str) -> None:
    """Open a PDF and print page-count related viewer metadata."""
    viewer = _create_viewer()
    try:
        viewer.open_pdf_file(infile)
        print(f"Page count: {viewer.page_count}")
        print(f"Coordinate type: {viewer.coordinate_type}")
        print(f"Resolution: {viewer.resolution}")
    finally:
        viewer.close_pdf_file()

Python-Net: فئة النموذج

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

Python-Net: فئة الطوابع

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

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

توضح هذه المقالة العديد من عمليات سير عمل الطوابع الشائعة:

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

يستخدم المثال وظيفتين مساعدتين: واحدة تنشئ نصًا منسقًا للطوابع النصية، والأخرى تنشئ TextState الكائن المستخدم لتصميم الطوابع النصية.

import sys
from os import path

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

from config import initialize_data_dir, set_license


def _create_text_logo(text: str) -> pdf_facades.FormattedText:
    """Create formatted text for text stamp examples."""
    return pdf_facades.FormattedText(
        text,
        drawing.Color.blue,
        drawing.Color.light_gray,
        pdf_facades.FontStyle.HELVETICA_BOLD,
        pdf_facades.EncodingType.WINANSI,
        True,
        14,
    )


def _create_text_state() -> ap.text.TextState:
    """Create a text state used to style text stamps."""
    text_state = ap.text.TextState()
    text_state.foreground_color = ap.Color.dark_blue
    text_state.font_size = 16
    text_state.font_style = ap.text.FontStyles.BOLD
    return text_state

إضافة طابع صورة

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

import sys
from os import path

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

from config import initialize_data_dir, set_license


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

        stamp = pdf_facades.Stamp()
        stamp.bind_image(image_file)
        stamp.stamp_id = 1
        stamp.set_origin(36, 520)

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

إضافة صفحة PDF كطابع

استخدم bind_pdf() عندما تريد استخدام صفحة من ملف PDF آخر كمحتوى ختم. يعد هذا مفيدًا للتراكبات مثل الموافقات أو القوالب أو العناصر المرئية التي تم إنشاؤها مسبقًا المخزنة في مستند منفصل.

import sys
from os import path

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

from config import initialize_data_dir, set_license


def add_pdf_page_as_stamp(infile: str, stamp_pdf: str, outfile: str) -> None:
    """Add the first page of another PDF as a stamp."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)

        stamp = pdf_facades.Stamp()
        stamp.bind_pdf(stamp_pdf, 1)
        stamp.page_number = 1
        stamp.set_origin(36, 250)

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

أضف طابعًا نصيًا مع حالة النص

استخدم bind_logo() جنبا إلى جنب مع bind_text_state() عندما تريد إنشاء طابع نصي باستخدام نمط خط مخصص. يُعد هذا الأسلوب مفيدًا لعلامات الموافقة والتسميات والتعليقات التوضيحية الخاصة بسير العمل.

import sys
from os import path

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

from config import initialize_data_dir, set_license


def add_text_stamp_with_text_state(infile: str, outfile: str) -> None:
    """Add a text stamp and style it with a TextState object."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)

        stamp = pdf_facades.Stamp()
        stamp.bind_logo(_create_text_logo("Approved by signing workflow"))
        stamp.bind_text_state(_create_text_state())
        stamp.set_origin(36, 700)
        stamp.rotation = 15.0

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

إضافة طابع إلى صفحات محددة

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

import sys
from os import path

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

from config import initialize_data_dir, set_license


def add_stamp_to_specific_pages(infile: str, image_file: str, outfile: str) -> None:
    """Add an image stamp only to the selected pages."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)

        stamp = pdf_facades.Stamp()
        stamp.bind_image(image_file)
        stamp.pages = [1]
        stamp.set_origin(400, 40)
        stamp.set_image_size(120, 60)

        pdf_stamper.add_stamp(stamp)
        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
import aspose.pydrawing as drawing

from config import initialize_data_dir, set_license


def add_background_image_stamp(infile: str, image_file: str, outfile: str) -> None:
    """Add a rotated background image stamp with opacity and quality settings."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)

        stamp = pdf_facades.Stamp()
        stamp.bind_image(image_file)
        stamp.is_background = True
        stamp.opacity = 0.35
        stamp.quality = 90
        stamp.rotation = 45.0
        stamp.set_image_size(160, 80)
        stamp.set_origin(200, 300)

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

موضوعات الواجهات ذات الصلة

Python-Net: فئة ختم ملفات PDF

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

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

ما يمكنك القيام به باستخدام PDFFileStamp

استخدم المقالات الموجودة في هذا القسم لاستكشاف مهام الختم الرئيسية التي يدعمها PdfFileStamp الواجهة: