كيفية تنسيق النص في 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 frameA 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