كيفية تنسيق النص في بايثون

توفر Aspose.Slides FOSS for Python تنسيق نص دقيق من خلال الفئة PortionFormat. الـ Portion هو أصغر وحدة مستقلة من النص؛ وهو يطابق تشغيل تنسيق واحد داخل الفقرة. يوضح هذا الدليل كيفية تطبيق تنسيق الغامق والمائل وحجم الخط واللون على النص في عرض تقديمي.

دليل خطوة بخطوة

الخطوة 1: تثبيت الحزمة

pip install aspose-slides-foss

الخطوة 2: إضافة شكل مع إطار نص

قبل تنسيق النص، يجب أن يحتوي الشكل على TextFrame. استخدم shape.add_text_frame() لإنشاء واحد.

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    slide = prs.slides[0]
    shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 500, 150)
    tf = shape.add_text_frame("Default text: will be formatted")
    prs.save("output.pptx", SaveFormat.PPTX)

الخطوة 3: الوصول إلى TextFrame

shape.add_text_frame() تُعيد كائن TextFrame. يمكنك أيضًا استرجاعه لاحقًا عبر shape.text_frame.

tf = shape.text_frame          # if the frame already exists
tf = shape.add_text_frame("") # creates a new frame

TextFrame يحتوي على قائمة من كائنات Paragraph (tf.paragraphs). كل Paragraph يحتوي على كائنات Portion (paragraph.portions).


الخطوة 4: تطبيق التنسيق الغامق والمائل

استخدم portion_format.font_bold و portion_format.font_italic. هذه الخصائص تقبل NullableBool.TRUE، NullableBool.FALSE، أو NullableBool.NOT_DEFINED (وراثة من master).

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType, NullableBool
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    slide = prs.slides[0]
    shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 500, 150)
    tf = shape.add_text_frame("Bold and italic text")

    fmt = tf.paragraphs[0].portions[0].portion_format
    fmt.font_bold = NullableBool.TRUE
    fmt.font_italic = NullableBool.TRUE

    prs.save("bold-italic.pptx", SaveFormat.PPTX)

الخطوة 5: تعيين حجم الخط واللون

قم بتعيين portion_format.font_height للحجم (بالنقاط) واستخدم fill_format للون.

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType, NullableBool, FillType
from aspose.slides_foss.drawing import Color
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    slide = prs.slides[0]
    shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 500, 150)
    tf = shape.add_text_frame("Large corporate-blue heading")

    fmt = tf.paragraphs[0].portions[0].portion_format
    fmt.font_height = 32                          # 32pt font
    fmt.font_bold = NullableBool.TRUE
    fmt.fill_format.fill_type = FillType.SOLID
    fmt.fill_format.solid_fill_color.color = Color.from_argb(255, 0, 70, 127)

    prs.save("colored-text.pptx", SaveFormat.PPTX)

Color.from_argb(alpha, red, green, blue) يقبل القيم من 0 إلى 255 لكل قناة.


الخطوة 6: أجزاء متعددة في فقرة واحدة

يمكن لفقرة واحدة أن تحتوي على عدة أجزاء بتنسيقات مختلفة. أضف Portion جديدًا إلى مجموعة portions للفقرة:

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType, NullableBool, FillType
from aspose.slides_foss.drawing import Color
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    slide = prs.slides[0]
    shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 600, 100)
    tf = shape.add_text_frame("")  # start with empty frame

    paragraph = tf.paragraphs[0]

    # First portion: normal text
    portion1 = paragraph.portions[0]
    portion1.text = "Normal text followed by "
    portion1.portion_format.font_height = 20

    # Second portion: bold red text
    portion2 = slides.Portion()
    portion2.text = "bold red text"
    portion2.portion_format.font_height = 20
    portion2.portion_format.font_bold = NullableBool.TRUE
    portion2.portion_format.fill_format.fill_type = FillType.SOLID
    portion2.portion_format.fill_format.solid_fill_color.color = Color.from_argb(255, 200, 0, 0)
    paragraph.portions.add(portion2)

    prs.save("mixed-format.pptx", SaveFormat.PPTX)

المشكلات الشائعة والحلول

النص يظهر باللون الأسود حتى بعد تعيين اللون

تأكد من ضبط fill_format.fill_type = FillType.SOLID قبل تعيين اللون. بدون ضبط نوع التعبئة، قد لا يكون لتغيير اللون أي تأثير.

NullableBool.TRUE مقابل True

portion_format.font_bold يتوقع NullableBool.TRUE، وليس Python True. قد يؤدي تعيين Python True إلى رفع TypeError أو لا يفعل شيئًا بصمت اعتمادًا على الربط.

الخط لا يظهر في الملف المحفوظ

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


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

كيف يمكنني تغيير عائلة الخط؟

تعيين portion_format.latin_font:

fmt.latin_font = slides.FontData("Arial")

FontData يقبل اسم عائلة الخط كسلسلة.

كيف أقوم بتعيين محاذاة الفقرة؟

استخدم paragraph_format.alignment:

from aspose.slides_foss import TextAlignment

tf.paragraphs[0].paragraph_format.alignment = TextAlignment.CENTER

القيم المدعومة: LEFT, CENTER, RIGHT, JUSTIFY.

كيف أضبط تباعد الأسطر؟

استخدم paragraph_format.space_before (نقاط قبل الفقرة) أو paragraph_format.space_after (نقاط بعد الفقرة):

tf.paragraphs[0].paragraph_format.space_before = 12   # 12pt before
tf.paragraphs[0].paragraph_format.space_after = 6     # 6pt after

انظر أيضًا

 العربية