Documentation – تعديل حقول النموذج

Python-Net: إضافة عنصر قائمة

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

تسمح حقول مربع القائمة في ملفات PDF للمستخدمين بتحديد خيار واحد أو عدة خيارات من مجموعة محددة مسبقًا. باستخدام Aspose.PDF لـ Python، يمكن للمطورين إضافة عناصر جديدة برمجيًا إلى هذه الحقول. ال المحرر السابق توفر الفئة طريقة «add_list_item» لإلحاق العناصر بحقل مربع القائمة الحالي.

افتح نموذج PDF موجود.
قم بإنشاء كائن ForMeditor.
قم بربط ملف PDF إلى ForMeditor.
أضف عناصر إلى حقل مربع القائمة «البلد».
احفظ المستند المحدث.

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def add_list_item(infile, outfile):
    # Create FormEditor object
    form_editor = pdf_facades.FormEditor()
    # Bind document to FormEditor
    form_editor.bind_pdf(infile)
    # Add list item to list box field
    form_editor.add_list_item("Country", ["New Zealand", "New Zealand"])
    # Save updated document
    form_editor.save(outfile)

Python-Net: نسخ الحقل الداخلي

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

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

تشرح هذه المقالة كيفية نسخ حقل باسم «الاسم الأول» إلى حقل جديد يسمى «نسخ الاسم الأول» في الصفحة 2 بإحداثيات محددة (x=200، y=600)، وإنتاج ملف PDF مع الحقل الذي تم وضعه حديثًا.

افتح نموذج PDF موجود.
قم بإنشاء كائن ForMeditor.
قم بربط وثيقة PDF إلى ForMeditor.
انسخ حقل «الاسم الأول» إلى حقل جديد «نسخ الاسم الأول» في الصفحة 2 عند الإحداثيات (200، 600).
احفظ المستند المحدث.

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def copy_inner_field(infile, outfile):
    # Create FormEditor object
    form_editor = pdf_facades.FormEditor()
    # Bind document to FormEditor
    form_editor.bind_pdf(infile)
    # Copies an existing field to a new position specified by both page number and ordinates.
    # A new document will be produced, which contains everything the source document has except for the newly copied field.
    form_editor.copy_inner_field("First Name", "First Name Copy", 2, 200, 600)
    # Save updated document
    form_editor.save(outfile)

**يرجى ملاحظة ما يلي: **

يبدو توقيع الأسلوب «copy_inner_field» كما يلي:

copy_inner_field(original_field_name, new_field_name, page_number, x, y)

‘original_field_name’ - الحقل الذي تريد تكراره.
’new_field_name’ — اسم الحقل الجديد.
‘page_number’ - الصفحة التي سيظهر عليها الحقل الجديد.
x، y - الإحداثيات على تلك الصفحة.

من المتوقع أن يكون page_number عددًا صحيحًا موجبًا يتوافق مع صفحة موجودة في PDF (الفهرسة المستندة إلى 1).

إذا قمت بتمرير معامل سلبي، على سبيل المثال:

form_editor.copy_inner_field("First Name", "First Name Copy", -1, 200, 600)

سيتم إعادة تعيين البرنامج بعد ذلك إلى المعلمات السابقة.

Python-Net: نسخ الحقل الخارجي

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

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

ال المحرر السابق توفر الفئة طريقة «copy_outer_field»، التي تنسخ حقلاً من مستند مصدر إلى مستند هدف في صفحة وإحداثيات محددة.

يقوم الكود بإنشاء PDF جديد (هدف) وإضافة صفحة ثم نسخ حقل من PDF موجود (المصدر) إلى المستند الهدف بإحداثيات محددة.

قم بإنشاء مستند PDF مستهدف جديد.
أضف صفحة واحدة على الأقل إلى PDF الهدف.
احفظ المستند الهدف الفارغ.
قم بإنشاء كائن ForMeditor واربطه بملف PDF الهدف.
انسخ حقل «الاسم الأول» من ملف PDF المصدر إلى الصفحة 1 على (200، 600).
احفظ ملف PDF الهدف المحدث.

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def copy_outer_field(infile, outfile):
    # Since copy_outer_field() method needs to copy field from source document to target document, we need to create a new document as target document first.
    doc = ap.Document()
    doc.pages.add()
    doc.save(outfile)

    # Create FormEditor object
    form_editor = pdf_facades.FormEditor()
    # Bind document to FormEditor
    form_editor.bind_pdf(outfile)
    # Copies an existing field to a new position specified by both page number and ordinates.
    # A new document will be produced, which contains everything the source document has except for the newly copied field.
    form_editor.copy_outer_field(infile, "First Name", 1, 200, 600)
    # Save updated document
    form_editor.save(outfile)

**يرجى ملاحظة ما يلي: **

يبدو توقيع الأسلوب «copy_outer_field» كما يلي:

copy_outer_field(original_field_name, new_field_name, page_number, x, y)

‘original_field_name’ - الحقل الذي تريد تكراره.
’new_field_name’ — اسم الحقل الجديد.
‘page_number’ - الصفحة التي سيظهر عليها الحقل الجديد.
x، y - الإحداثيات على تلك الصفحة.

من المتوقع أن يكون page_number عددًا صحيحًا موجبًا يتوافق مع صفحة موجودة في PDF (الفهرسة المستندة إلى 1).

إذا قمت بتمرير معامل سلبي، على سبيل المثال:

form_editor.copy_outer_field("First Name", "First Name Copy", 1, -200, 600)

سيتم إعادة تعيين البرنامج بعد ذلك إلى المعلمات السابقة.

Python-Net: حذف عنصر القائمة

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

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

تشرح هذه المقالة كيفية حذف عنصر «المملكة المتحدة» من حقل مربع القائمة المسمى «البلد»، مع التأكد من أن الحقل يحتوي فقط على الخيارات المطلوبة.

ال المحرر السابق توفر الفئة طريقة «del_list_item» لإزالة عنصر معين من حقل مربع القائمة.

افتح نموذج PDF موجود.
قم بإنشاء كائن ForMeditor.
قم بربط وثيقة PDF إلى ForMeditor.
احذف عنصر «المملكة المتحدة» من حقل مربع قائمة «البلد».
احفظ المستند المحدث.

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def del_list_item(infile, outfile):
    # Create FormEditor object
    form_editor = pdf_facades.FormEditor()
    # Bind document to FormEditor
    form_editor.bind_pdf(infile)
    # Delete list item from list box field
    form_editor.del_list_item("Country", "UK")
    # Save updated document
    form_editor.save(outfile)

Python-Net: نقل الحقل

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

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

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

افتح نموذج PDF الحالي.
قم بإنشاء كائن ForMeditor.
قم بربط وثيقة PDF إلى ForMeditor.
انقل حقل «البلد» إلى موضع جديد باستخدام الإحداثيات.
احفظ المستند المعدل.

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def move_field(infile, outfile):
    # Create FormEditor object
    form_editor = pdf_facades.FormEditor()
    # Bind document to FormEditor
    form_editor.bind_pdf(infile)
    # Move field to new page
    form_editor.move_field("Country", 200, 600, 280, 620)
    # Save updated document
    form_editor.save(outfile)

Python-Net: إزالة الحقل

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

قد تحتوي نماذج PDF على حقول لم تعد مطلوبة بسبب تغييرات التصميم أو تحديثات سير العمل. باستخدام Aspose.PDF لـ Python، يمكن للمطورين بسهولة إزالة حقول نموذج معينة برمجيًا.

ال المحرر السابق توفر الفئة في Aspose.PDF طريقة «remove_field»، والتي تسمح للمطورين بحذف حقل النموذج باسمه.

قم بتحميل وثيقة PDF.
قم بإنشاء كائن ForMeditor.
قم بربط ملف PDF إلى ForMeditor.
قم بإزالة حقل النموذج المحدد.
احفظ المستند المحدث.

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def remove_field(infile, outfile):
    # Create FormEditor object
    form_editor = pdf_facades.FormEditor()
    # Bind document to FormEditor
    form_editor.bind_pdf(infile)
    # Remove field from document
    form_editor.remove_field("Country")
    # Save updated document
    form_editor.save(outfile)

Python-Net: إعادة تسمية الحقل

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

غالبًا ما تعتمد نماذج PDF على أسماء الحقول للبرمجة والأتمتة ومعالجة البيانات. باستخدام Aspose.PDF لـ Python، يمكن للمطورين إعادة تسمية الحقول الموجودة دون إعادة إنشائها أو تغيير تخطيط النموذج.

ال المحرر السابق يوفر class طريقة «rename_field»، والتي تسمح للمطورين بتغيير اسم حقل موجود مع الحفاظ على موضعه وقيمته ومظهره.

قم بتحميل نموذج PDF الموجود.
قم بإنشاء مثيل ForMeditor.
قم بربط وثيقة PDF بالمحرر.
أعد تسمية الحقل الهدف.
احفظ ملف PDF المحدث.

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def rename_field(infile, outfile):
    # Create FormEditor object
    form_editor = pdf_facades.FormEditor()
    # Bind document to FormEditor
    form_editor.bind_pdf(infile)
    # Rename field in document
    form_editor.rename_field("City", "Town")
    # Save updated document
    form_editor.save(outfile)

Python-Net: حقل أحادي الخط إلى حقل متعدد الأسطر

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

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

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

قم بتحميل وثيقة PDF الموجودة.
قم بإنشاء مثيل ForMeditor.
قم بربط وثيقة PDF بالمحرر.
قم بتحويل الحقل المحدد إلى متعدد الأسطر.
احفظ المستند المحدث.

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def single2multiple(infile, outfile):
    # Create FormEditor object
    form_editor = pdf_facades.FormEditor()
    # Bind document to FormEditor
    form_editor.bind_pdf(infile)
    # Change a single-lined text field to a multiple-lined one
    form_editor.single_2_multiple("City")
    # Save updated document
    form_editor.save(outfile)