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

المقدمة

في Aspose.Slides for Python via Java، يتم تخزين نص الشرائح في إطارات نصية تتبع الأشكال. تمثل فئة AutoShape الشكل الأكثر شيوعًا الذي يحمل نصًا وتعرض نصه عبر طريقة AutoShape.getTextFrame.

إنشاء مربع نص على شريحة

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

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat, ShapeType

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    text_box = slide.getShapes().addAutoShape(ShapeType.Rectangle, 150, 75, 300, 50)
    text_box.addTextFrame("Aspose TextBox")

    presentation.save("TextBox.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

الإحداثيات والأبعاد التي تُمرَّر إلى ShapeCollection.addAutoShape تُقاس بالنقاط. تقوم AutoShape.addTextFrame بتهيئة الإطار النصي بالنص المقدم.

التحقق من شكل مربع النص

استخدم طريقة AutoShape.isTextBox لتحديد ما إذا كان الشكل التلقائي يُعامل كمربع نص. هذا مفيد عندما يحتوي العرض التقديمي على أشكال تلقائية تحمل نصًا وأخرى رسومية بحتة.

مربع نص وشكل

المثال التالي يفحص كل شكل تلقائي في العرض التقديمي:

import jpype
import asposeslides

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

from asposeslides.api import AutoShape, Presentation, ShapeType

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    text_box = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 10, 120, 40)
    text_box.addTextFrame("Text box")
    slide.getShapes().addAutoShape(ShapeType.Ellipse, 150, 10, 40, 40)

    for current_slide in presentation.getSlides():
        for shape in current_slide.getShapes():
            if isinstance(shape, AutoShape):
                print("The shape is a text box." if shape.isTextBox() else "The shape is not a text box.")
finally:
    presentation.dispose()

لا يُعتبر الشكل التلقائي المضاف حديثًا مربع نص حتى يحتوي على نص غير فارغ. يمكنك توفير هذا النص عبر AutoShape.addTextFrame أو TextFrame.setText. إضافة أو تعيين سلسلة فارغة تجعل AutoShape.isTextBox تُعيد False:

import jpype
import asposeslides

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

from asposeslides.api import Presentation, ShapeType

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    added_text_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 10, 100, 40)
    added_text_shape.addTextFrame("Shape 1")
    print(added_text_shape.isTextBox())

    assigned_text_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 70, 100, 40)
    assigned_text_shape.getTextFrame().setText("Shape 2")
    print(assigned_text_shape.isTextBox())

    added_empty_text_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 130, 100, 40)
    added_empty_text_shape.addTextFrame("")
    print(added_empty_text_shape.isTextBox())

    assigned_empty_text_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 190, 100, 40)
    assigned_empty_text_shape.getTextFrame().setText("")
    print(assigned_empty_text_shape.isTextBox())
finally:
    presentation.dispose()

تطبع الاستدعاءات الأولى اثنين True؛ والاثنان الأخيرين False.

العثور على الشكل الذي يمتلك إطار نص

قد يتلقى كود معالجة النص العام كائنًا من نوع TextFrame دون معرفة أي كائن عرض تقديمي يحتويه. استخدم طريقة القراءة فقط TextFrame.getParentShape للعودة إلى الشكل المالك لـ Shape.

بالنسبة لإطار نص مملوك لشكل تلقائي أو إلى شكل آخر يحمل نصًا، تُعيد TextFrame.getParentShape المالك وتُعيد TextFrame.getParentCell القيمة None. تحقق من القيمة المُسترجعة قبل الوصول إليها. لتحديد كلٍ من مالكي الشكل وخلايا الجدول، بما في ذلك الأشكال المرتبطة بعُقد SmartArt، راجع Search and Replace Text.

إضافة أعمدة إلى مربع النص

طريقة TextFrameFormat.setColumnCount تقسم إطار النص إلى أعمدة، بينما تُحدد طريقة TextFrameFormat.setColumnSpacing الفراغ بين الأعمدة بالنقاط. كلا الإعدادين ينتميان إلى TextFrameFormat ويمكن تغييره من خلال إطار النص لمربع نص موجود. يتدفق النص بين الأعمدة داخل الشكل نفسه؛ ولا يستمر إلى شكل آخر.

المثال التالي ينشئ مربع نص بثلاثة أعمدة مع 10 نقاط بين الأعمدة، يحفظ العرض التقديمي، ويقرئ الإعدادات المخزنة من ملف الإخراج:

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat, ShapeType

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    text_box = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 300, 200)
    text_box.addTextFrame("This text is distributed automatically across all columns in the text box.")

    text_frame_format = text_box.getTextFrame().getTextFrameFormat()
    text_frame_format.setColumnCount(3)
    text_frame_format.setColumnSpacing(10)

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

    saved_presentation = Presentation("TextBoxColumns.pptx")
    try:
        saved_text_box = saved_presentation.getSlides().get_Item(0).getShapes().get_Item(0)
        saved_format = saved_text_box.getTextFrame().getTextFrameFormat()
        print(f"Columns: {saved_format.getColumnCount()}; spacing: {saved_format.getColumnSpacing()} points")
    finally:
        saved_presentation.dispose()
finally:
    presentation.dispose()

استخراج النص من الأعمدة الفردية

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

هذا مفيد عندما تحتاج إلى:

  • استخراج النص مع الحفاظ على ترتيب القراءة القائم على الأعمدة.
  • فهرسة أو مقارنة محتوى الشرائح متعددة الأعمدة.
  • تصدير كل عمود إلى ملف منفصل، حقل قاعدة بيانات، أو وجهة أخرى.
  • فحص كيفية إعادة توزيع النص بعد تغيير عدد الأعمدة باستخدام TextFrameFormat.setColumnCount، أو الفراغ باستخدام TextFrameFormat.setColumnSpacing، أو الخط، أو حجم إطار النص.

الطريقة تُبلّغ عن النص الموزع داخل TextFrame الحالي؛ ولا تُسْقِط النص تلقائيًا بين أشكال أو مربعات نص منفصلة. يمكن أن يعتمد توزيع الأعمدة على الخطوط المتوفرة وإعدادات تخطيط النص الأخرى، لذا تأكد من توفر الخطوط المطلوبة عندما تكون النتائج المتناسقة مهمة.

المثال التالي يحمِّل عرضًا تقديميًا، يجد أول شكل تلقائي متعدد الأعمدة يحتوي على إطار نص، يقرء عدد الأعمدة المُكوَّن، ويكتب نص كل عمود إلى ملف منفصل. تُستبعد الأشكال التي لا توفر إطار نص.

import jpype
import asposeslides

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

from pathlib import Path
from asposeslides.api import AutoShape, Presentation

presentation = Presentation("MultiColumnText.pptx")
try:
    text_box = None
    for shape in presentation.getSlides().get_Item(0).getShapes():
        if isinstance(shape, AutoShape):
            if shape.getTextFrame() is not None:
                column_count = shape.getTextFrame().getTextFrameFormat().getColumnCount()
                if column_count > 1:
                    text_box = shape
                    break

    if text_box is None:
        print("No multi-column text frame was found.")
    else:
        text_frame = text_box.getTextFrame()
        configured_column_count = text_frame.getTextFrameFormat().getColumnCount()
        column_texts = text_frame.splitTextByColumns()

        print(f"Configured columns: {configured_column_count}")

        for column_number, column_text in enumerate(column_texts, start=1):
            print(f"Column {column_number}: {column_text}")
            output_path = Path(f"Column-{column_number}.txt")
            try:
                output_path.write_text(str(column_text), encoding="utf-8")
            except OSError as exception:
                print(f"Could not write column {column_number}: {exception}")
finally:
    presentation.dispose()

تحديث النص

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

المثال التالي يستبدل كل ظهور لكلمة years بـ months في نص الشكل التلقائي ويجعل كل جزء متأثر غامقًا:

import jpype
import asposeslides

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

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

presentation = Presentation("Text.pptx")
try:
    for slide in presentation.getSlides():
        for shape in slide.getShapes():
            if not isinstance(shape, AutoShape):
                continue

            text_frame = shape.getTextFrame()
            if text_frame is None:
                continue

            for paragraph in text_frame.getParagraphs():
                for portion in paragraph.getPortions():
                    text = portion.getText()
                    if text is not None and "years" in str(text):
                        portion.setText(str(text).replace("years", "months"))
                        portion.getPortionFormat().setFontBold(NullableBool.True_)

    presentation.save("TextChanged.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

هذا التجوال يُحدِّث النص فقط في الأشكال التلقائية. النص المخزن في الجداول أو المخططات أو SmartArt أو الأشكال المجمعة يتطلب تجوال مجموعات تلك الكائنات الخاصة.

إضافة مربع نص مع ارتباط تشعبي

يمكن تعيين ارتباط تشعبي إلى جزء نص محدد، بحيث يعمل ذلك الجزء فقط كرابط قابل للنقر. استخدم HyperlinkManager.setExternalHyperlinkClick لربط الجزء بعنوان URL خارجي.

المثال التالي ينشئ نصًا مرتبطًا ويحفظه إلى عرض تقديمي:

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat, ShapeType

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    text_box = slide.getShapes().addAutoShape(ShapeType.Rectangle, 150, 150, 200, 50)
    text_box.addTextFrame("Aspose.Slides")

    text_portion = text_box.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0)
    text_portion.getPortionFormat().getHyperlinkManager().setExternalHyperlinkClick("https://www.aspose.com/")

    presentation.save("Hyperlink.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

الأسئلة المتكررة

ما هو الفرق بين مربع النص وعنصر النائب النصي على شريحة رئيسية أو شريحة تخطيط؟

يمكن لـ placeholder أن يرث موضعه وتنسيقه من master slide أو layout slide. مربع النص العادي هو شكل مستقل على الشريحة التي تم إنشاؤه فيها ولا يكتسب سلوك العنصر النائب عندما يتغير التخطيط.

كيف يمكنني استبدال النص دون تغيير النص في المخططات أو الجداول أو SmartArt؟

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

إدارة العناصر النائبة في العروض التقديمية باستخدام Python حسّن عروضك التقديمية باستخدام AutoFit في بايثون