كيفية تنسيق النص في Python

Aspose.Slides FOSS for Python provides fine-grained text formatting through the PortionFormat الفئة. A Portion هو أصغر وحدة مستقلة من النص؛ يطابق تشغيل تنسيق واحد داخل الفقرة. يوضح هذا الدليل كيفية تطبيق bold, italic, font size, وcolor على النص في عرض تقديمي.

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

الخطوة 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

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


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

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

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: عدة Portions في فقرة واحدة

يمكن لفقرة واحدة أن تحتوي على عدة أجزاء بتنسيق مختلف. أضف جديدًا 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

انظر أيضًا

 العربية