كيفية تنسيق النص في بايثون
توفر 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 frameTextFrame يحتوي على قائمة من كائنات 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