إدارة حقول النص في عروض PowerPoint التقديمية باستخدام Python عبر Java

عن ماذا تتحدث هذه الصفحة

إنشاء، فحص، تعديل، وإزالة حقول النص في عروض PowerPoint التقديمية باستخدام Aspose.Slides لـ Python عبر Java. الحفاظ على التنسيق والتحقق من ملفات PPTX و PPT المحفوظة.

نظرة عامة

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

استخدم Portion.getField للتمييز بينهما: يكون None للنص العادي. يقوم Portion.addField بتحويل الجزء الموجود إلى حقل. احتفظ بالتسمية والقيمة الديناميكية في أجزاء منفصلة بحيث لا يؤدي تحويل القيمة إلى استبدال التسمية.

يغطي هذا الدليل الحقول داخل النص، تنسيقها، وحفظها في PPTX و PPT. لإطارات النص والفقرات، راجع إدارة النص.

إنشاء حقل رقم الشريحة

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

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, Portion, ShapeType, NullableBool, FillType, FieldType, SaveFormat
from java.awt import Color

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 40, 40, 240, 50)
    shape.addTextFrame("Slide ")
    paragraph = shape.getTextFrame().getParagraphs().get_Item(0)

    number_portion = Portion()
    number_color = Color(0, 0, 139)
    number_portion.getPortionFormat().setFontHeight(24)
    number_portion.getPortionFormat().setFontBold(NullableBool.True_)
    number_portion.getPortionFormat().getFillFormat().setFillType(FillType.Solid)
    number_portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(number_color)
    paragraph.getPortions().add(number_portion)
    number_portion.addField(FieldType.getSlideNumber())

    presentation.save("slide_number.pptx", SaveFormat.Pptx)

    reopened = Presentation("slide_number.pptx")
    try:
        saved_shape = reopened.getSlides().get_Item(0).getShapes().get_Item(0)
        saved_number = saved_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(1)
        saved_field = saved_number.getField()
        has_number_field = saved_field is not None and saved_field.getType().getInternalString() == FieldType.getSlideNumber().getInternalString()
        portion_format = saved_number.getPortionFormat()
        formatting_preserved = portion_format.getFontHeight() == 24 and portion_format.getFontBold() == NullableBool.True_
        formatting_preserved = formatting_preserved and portion_format.getFillFormat().getSolidFillColor().getColor().getRGB() == number_color.getRGB()

        print(f"Text: {saved_shape.getTextFrame().getText()}")
        print(f"Slide number field: {has_number_field}")
        print(f"Formatting preserved: {formatting_preserved}")
    finally:
        reopened.dispose()
finally:
    presentation.dispose()

يبدأ العرض التقديمي الجديد برقم الشريحة 1، لذا يكون النص Slide 1، وتطبع كلا الفحصين True. يظل الرقم حقلًا بعد إعادة الفتح؛ فهو ليس حرفيًا 1. المؤشرات في التحقق تشير إلى الشكل والأجزاء التي أنشأها هذا المثال.

اختيار نوع الحقل

FieldType يوفر الطرق التالية للحصول على القيم المعرفة مسبقًا. مرّر القيمة المناسبة إلى addField.

الطريقة	الهدف
getSlideNumber	رقم الشريحة الحالي.
getDateTime	التاريخ/الوقت بصيغة التطبيق الافتراضية.
getDateTime1–getDateTime9	صيغ تاريخ أو تاريخ/وقت معرفة مسبقًا.
getDateTime10–getDateTime13	صيغ وقت معرفة مسبقًا، مع خيارات للثواني وساعة 12.
getHeader	حقل رأس؛ انظر قيود العناصر النائبة والصيغة أدناه.
getFooter	حقل تذييل.

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

إنشاء حقل من سلسلة داخلية

تحمل النسخة النصية من addField معرف حقل داخلي. استخدمها عندما تريد الحفاظ على معرف قدمه تطبيق آخر لا يمتلك قيمة معرفة مسبقًا. يمكنك أيضًا إنشاء FieldType من المعرف. يوضح FieldType.getInternalString هذا المعرف للتفحص.

هذا المثال يخزن حقلًا خاصًا بالتطبيق custom‑report‑id مع النص الاحتياطي Report‑042. المعرف لا يسجل حسابًا: Aspose.Slides لا يولد معرفات تقارير لأنواع غير معروفة. يجب على التطبيق الذي يفهم هذا المعرف توفير معناه وتحديث قيمته.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType, SaveFormat

presentation = Presentation()
try:
    shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 40, 40, 300, 50)
    shape.addTextFrame("Report-042")
    portion = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0)
    portion.addField("custom-report-id")

    presentation.save("custom_field.pptx", SaveFormat.Pptx)

    reopened = Presentation("custom_field.pptx")
    try:
        saved_shape = reopened.getSlides().get_Item(0).getShapes().get_Item(0)
        saved_portion = saved_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0)
        saved_field = saved_portion.getField()
        type_name = "ordinary text" if saved_field is None else saved_field.getType().getInternalString()
        print(f"Type: {type_name}")
        print(f"Text: {saved_portion.getText()}")
    finally:
        reopened.dispose()
finally:
    presentation.dispose()

بعد جولة حفظ وإعادة فتح PPTX، يكون النوع custom‑report‑id والنص Report‑042. تمرير سلسلة مثل yyyy‑MM‑dd سيُسمّي نوع حقل؛ لن يكوّن تنسيق تاريخ مخصص. لتاريخ ثابت بصيغة عشوائية استخدم نصًا عاديًا.

فحص وتعديل وإزالة حقول التاريخ/الوقت

غيّر حقلًا موجودًا عبر Field.setType. تأكد من وجود الحقل قبل الوصول إلى نوعه. لإيقاف التحديثات التلقائية، استدعِ Portion.removeField. هذا يحافظ على الجزء والنص الحالي مع إزالة ارتباط الحقل. إذا احتجت قيمة ثابتة محددة، عيّن ذلك النص بعد إزالة الحقل.

لإعداد API المتعلق بمعالجة حقول التاريخ/الوقت، راجع Presentation.setCurrentDateTime. يستخدم المثال أدناه تاريخ موافقة صريح عند تحويل حقل إلى نص عادي.

حمّل sample.pptx وضعه في دليل العمل. يحتوي على شكلين نصيين مسمين، UpdatedAt و ApprovedDate، كل منهما حقل تاريخ/وقت، بالإضافة إلى تسميات نصية عادية. المثال التالي يمشي عبر أشكال النص العليا في الشرائح العادية. يغيّر حقول التاريخ/الوقت إلى صيغة تاريخ طويل ويجعلها مائلة، مع الحفاظ على تنسيقاتها الأخرى. فقط الحقول في ApprovedDate تتحول إلى نص ثابت.

الأمثلة تتعرف على المعرفات الداخلية المدمجة datetime و datetime1 حتى datetime13. المجموعات والجداول والملاحظات والتخطيطات والرؤوس تتطلب استعراض حاويات النص الخاصة بها وتخضع لنطاق هذا المثال.

import re
from datetime import date

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, AutoShape, FieldType, NullableBool, SaveFormat

presentation = Presentation("sample.pptx")
try:
    approval_date = date(2030, 4, 5)
    # استخدم أسماء الشهور الإنجليزية بشكل مستقل عن إعداد لغة النظام.
    month_names = ("January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December")
    fixed_date = f"{approval_date.day:02d} {month_names[approval_date.month - 1]} {approval_date.year}"

    for slide in presentation.getSlides():
        for shape in slide.getShapes():
            if not isinstance(shape, AutoShape):
                continue
            if shape.getTextFrame() is None:
                continue

            for paragraph in shape.getTextFrame().getParagraphs():
                for portion in paragraph.getPortions():
                    field = portion.getField()
                    if field is None:
                        continue

                    type_name = field.getType().getInternalString()
                    is_date_time = type_name is not None and re.fullmatch(r"datetime([1-9]|1[0-3])?", str(type_name)) is not None
                    if not is_date_time:
                        continue

                    field.setType(FieldType.getDateTime3())
                    portion.getPortionFormat().setLanguageId("en-US")
                    portion.getPortionFormat().setFontItalic(NullableBool.True_)

                    if shape.getName() == "ApprovedDate":
                        portion.removeField()
                        portion.setText(fixed_date)

    presentation.save("updated_dates.pptx", SaveFormat.Pptx)

    reopened = Presentation("updated_dates.pptx")
    try:
        for shape in reopened.getSlides().get_Item(0).getShapes():
            if not isinstance(shape, AutoShape):
                continue
            if shape.getTextFrame() is None:
                continue
            if shape.getName() not in ("UpdatedAt", "ApprovedDate"):
                continue

            portion = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0)
            field = portion.getField()
            type_name = "ordinary text" if field is None else field.getType().getInternalString()
            print(f"{shape.getName()}: {type_name}; {portion.getText()}")
            print(f"Italic: {portion.getPortionFormat().getFontItalic()}")
    finally:
        reopened.dispose()
finally:
    presentation.dispose()

بعد إعادة الفتح، يكون لـ UpdatedAt النوع datetime3 ويبقى ديناميكيًا. لا يحتوي ApprovedDate على حقل ويتضمن 05 April 2030. كلا جزئي التاريخ مائلان، وحجم الخط الأصلي، والإعداد الغامق، واللون يبقى كما هو. التسميات النصية العادية لم تتغير. يقرأ التحقق الجزء الأول من الشكلين المعروفين في العينة المقدمة.

الحفاظ على تنسيق النص

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

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

الحقول وعناصر النائب رأس/تذييل الصفحة

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

مديرو الرأس/التذييل يتحكمون في نص العنصر النائب ورؤيته على الشرائح، والتخطيطات، والرؤوس، بما في ذلك انتشارها إلى الشرائح التابعة. يمكن أن يكون حقل الرقم في صندوق نص مخصص مفيدًا حتى عندما لا تستخدم عنصر نائب رقم الشريحة. وعلى العكس، تغيير رؤية العنصر النائب لا يزيل حقلًا من صندوق نص غير مرتبط.

أنواع الرأس والتذييل المعرفة مسبقًا لا تُنشئ العناصر النائبة المقابلة ولا تزود محتواها. على وجه الخصوص، لا يحتوي الشريحة العادية في PowerPoint على عنصر نائب رأس؛ الرؤوس تخص صفحات الملاحظات والنشرات. لا تفترض أن حقل رأس أو تذييل في شكل عشوائي سيحصل تلقائيًا على النص المكوّن عبر مدير العنصر النائب. لهذا السيناريو، راجع رؤوس وتذييلات العرض التقديمي.

قيود PPTX و PPT

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

الصيغة	سلوك الحقل والقيود
PPTX	يخزن معرفات الحقول الداخلية جنبًا إلى جنب مع نص الحقل. في تحقق جولة الحفظ، بقت الأنواع المعرفة مسبقًا والمعرف المخصص المستخدم أعلاه بعد الحفظ وإعادة الفتح. احتفظ المعرف المخصص بنصه الاحتياطي؛ لم يكتسب منطق حساب تلقائي. قد يتعامل تطبيق آخر مع المعرفات غير المدعومة بشكل مختلف.
PPT	يستخدم تمثيلات حقول قديمة ويحتوي على توافقية محدودة. في تحقق جولة الحفظ، نجت حقول رقم الشريحة والحقول التاريخ/الوقت المعرفة مسبقًا. حقل مخصص في صندوق نص شريحة عادي أعيد فتحه بمعرفه لكن نصه كان *؛ حقل رأس في نفس السياق أيضًا نتج عنه *. لا تعتمد على أن الحقول المخصصة أو السياقات غير المدعومة ستحافظ على نصها الظاهر.

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

الأسئلة الشائعة

كيف يمكنني معرفة ما إذا كان الرقم أو التاريخ المعروض حقلًا؟
افحص Portion.getField. قيمة غير None تحدد وجود حقل؛ لا يمكن للنص المعروض وحده إخبارك بذلك.

هل إزالة الحقل يزيل نصه أو تنسيقه؟
لا. removeField يحول الجزء الحالي إلى نص عادي. عيّن قيمة صريحة بعد ذلك إذا احتجت تاريخًا ثابتًا أو نصًا احتياطيًا.

هل يمكن لسلسلة داخلية تعريف صيغة تاريخ جديدة أو معادلة؟
لا. هي مجرد معرف لنوع الحقل. المعرف غير المعروف لا يوفر مقيمًا ولا نمط تنسيق تاريخ بايثون. استخدم نوعًا معروفًا أو صغ القيمة كنص عادي.

لماذا أتحقق من العرض التقديمي مرة أخرى بعد حفظه؟
معرفات الحقول، النص المحسوب، والتنسيق أشياء منفصلة تحتاج للتحقق. قد يغيّر تحويل الصيغة النتيجة الظاهرة حتى عندما يبقى معرف الحقل موجودًا.