مدیریت پاراگراف‌های متن پاورپوینت در پایتون
نمای کلی
Aspose.Slides برای Python از طریق .NET متن را به‌صورت سلسله‌مراتبی از قاب‌های متن، پاراگراف‌ها و Portionها نمایش می‌دهد:
- TextFrame محفظهٔ متن را در یک شکل نشان می‌دهد و دسترسی به مجموعهٔ پاراگراف‌های آن را فراهم می‌کند.
- Paragraph یک پاراگراف در یک TextFrame را نشان می‌دهد و دسترسی به Portionها و قالب‌بندی سطح پاراگراف را فراهم می‌کند.
- Portion یک بخش متنی درون یک پاراگراف را نشان می‌دهد. هر Portion می‌تواند متن و قالب‌بندی سطح کاراکتری خود را داشته باشد.
بنابراین یک پاراگراف می‌تواند متن با فونت‌ها، رنگ‌ها، اندازه‌ها و قالب‌بندی‌های مختلف را با استفاده از چندین Portion داشته باشد.
ایجاد و قالب‌بندی پاراگراف‌ها
ایجاد پاراگراف‌ها با چندین Portion
مراحل زیر یک TextFrame با سه پاراگراف ایجاد می‌کند که هر کدام شامل سه Portion هستند:
- یک نمونه از کلاس Presentation ایجاد کنید.
- اسلاید مربوطه را از طریق ایندکس آن دسترسی پیدا کنید.
- یک AutoShape مستطیلی به اسلاید اضافه کنید.
- به TextFrame شکل دسترسی پیدا کنید.
- از پاراگراف پیش‌فرض استفاده کنید و دو شیء دیگر از نوع Paragraph را به TextFrame اضافه کنید.
- به اندازه کافی شیء Portion برای هر پاراگراف اضافه کنید تا شامل سه Portion باشد. پاراگراف پیش‌فرض از قبل یک Portion خالی دارد.
- متن هر Portion را تنظیم کنید.
- قالب‌بندی سطح کاراکتر را از طریق Portion.portion_format اعمال کنید.
- ارائهٔ تغییر یافته را ذخیره کنید.
import aspose.pydrawing as draw
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 150, 300, 150)
text_frame = shape.text_frame
first_paragraph = text_frame.paragraphs[0]
first_paragraph.portions.add(slides.Portion())
first_paragraph.portions.add(slides.Portion())
second_paragraph = slides.Paragraph()
second_paragraph.portions.add(slides.Portion())
second_paragraph.portions.add(slides.Portion())
second_paragraph.portions.add(slides.Portion())
text_frame.paragraphs.add(second_paragraph)
third_paragraph = slides.Paragraph()
third_paragraph.portions.add(slides.Portion())
third_paragraph.portions.add(slides.Portion())
third_paragraph.portions.add(slides.Portion())
text_frame.paragraphs.add(third_paragraph)
for paragraph_index in range(text_frame.paragraphs.count):
paragraph = text_frame.paragraphs[paragraph_index]
for portion_index in range(paragraph.portions.count):
portion = paragraph.portions[portion_index]
portion.text = f"Portion {paragraph_index + 1}.{portion_index + 1}"
if portion_index == 0:
portion.portion_format.fill_format.fill_type = slides.FillType.SOLID
portion.portion_format.fill_format.solid_fill_color.color = draw.Color.red
portion.portion_format.font_bold = slides.NullableBool.TRUE
portion.portion_format.font_height = 15
elif portion_index == 1:
portion.portion_format.fill_format.fill_type = slides.FillType.SOLID
portion.portion_format.fill_format.solid_fill_color.color = draw.Color.blue
portion.portion_format.font_italic = slides.NullableBool.TRUE
portion.portion_format.font_height = 18
presentation.save("paragraphs_with_portions.pptx", slides.export.SaveFormat.PPTX)
ایجاد فهرست‌های نقطه‌ای و شماره‌دار
ایجاد فهرست نقطه‌ای یا شماره‌دار
نقطه‌ها و شماره‌گذاری موارد مرتبط را برای اسکن آسان‌تر می‌کند. در Aspose.Slides، تنظیمات فهرست از طریق BulletFormat تعریف می‌شود.
- یک نمونه از کلاس Presentation ایجاد کنید.
- اسلاید مربوطه را از طریق ایندکس آن دسترسی پیدا کنید.
- یک AutoShape به اسلاید انتخاب‌شده اضافه کنید.
- به TextFrame شکل دسترسی پیدا کنید.
- پاراگراف پیش‌فرض را از TextFrame حذف کنید.
- یک Paragraph برای یک نقطهٔ نماد ایجاد کنید.
- BulletFormat.type را به BulletType.SYMBOL تنظیم کنید و کاراکتر نقطه را مشخص کنید.
- متن پاراگراف، تورفتگی، رنگ نقطه و ارتفاع نقطه را تنظیم کنید.
- پاراگراف را به TextFrame اضافه کنید.
- یک پاراگراف دوم ایجاد کنید و BulletFormat.type را به BulletType.NUMBERED تنظیم کنید.
- سبک نقطهٔ شماره‌دار را پیکربندی کنید و پاراگراف را به TextFrame اضافه کنید.
- ارائه را ذخیره کنید.
import aspose.pydrawing as draw
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 200, 400, 200)
text_frame = shape.text_frame
text_frame.paragraphs.clear()
symbol_paragraph = slides.Paragraph()
symbol_paragraph.text = "Welcome to Aspose.Slides"
symbol_paragraph.paragraph_format.bullet.type = slides.BulletType.SYMBOL
symbol_paragraph.paragraph_format.bullet.char = chr(0x2022)
symbol_paragraph.paragraph_format.indent = 25
symbol_paragraph.paragraph_format.bullet.color.color_type = slides.ColorType.RGB
symbol_paragraph.paragraph_format.bullet.color.color = draw.Color.black
symbol_paragraph.paragraph_format.bullet.is_bullet_hard_color = slides.NullableBool.TRUE
symbol_paragraph.paragraph_format.bullet.height = 100
text_frame.paragraphs.add(symbol_paragraph)
numbered_paragraph = slides.Paragraph()
numbered_paragraph.text = "This is a numbered item"
numbered_paragraph.paragraph_format.bullet.type = slides.BulletType.NUMBERED
numbered_paragraph.paragraph_format.bullet.numbered_bullet_style = slides.NumberedBulletStyle.BULLET_CIRCLE_NUM_WD_BLACK_PLAIN
numbered_paragraph.paragraph_format.indent = 25
numbered_paragraph.paragraph_format.bullet.color.color_type = slides.ColorType.RGB
numbered_paragraph.paragraph_format.bullet.color.color = draw.Color.black
numbered_paragraph.paragraph_format.bullet.is_bullet_hard_color = slides.NullableBool.TRUE
numbered_paragraph.paragraph_format.bullet.height = 100
text_frame.paragraphs.add(numbered_paragraph)
presentation.save("bulleted_and_numbered_list.pptx", slides.export.SaveFormat.PPTX)
استفاده از نقطه‌های تصویری
نقطه‌های تصویری به شما امکان می‌دهند به‌جای نماد یا شماره از یک تصویر سفارشی استفاده کنید.
- یک نمونه از کلاس Presentation ایجاد کنید.
- اسلاید مربوطه را از طریق ایندکس آن دسترسی پیدا کنید.
- یک AutoShape اضافه کنید و به TextFrame آن دسترسی پیدا کنید.
- پاراگراف پیش‌فرض را از TextFrame حذف کنید.
- تصویر نقطه را بارگذاری کنید و به‌عنوان یک PPImage به مجموعهٔ تصاویر ارائه اضافه کنید.
- یک Paragraph ایجاد کنید و متن آن را تنظیم کنید.
- BulletFormat.type را به BulletType.PICTURE تنظیم کنید.
- تصویر را از طریق BulletFormat.picture اختصاص دهید و ارتفاع نقطه را تنظیم کنید.
- پاراگراف را به TextFrame اضافه کنید.
- ارائهٔ تغییر یافته را ذخیره کنید.
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
with slides.Images.from_file("bullets.png") as bullet_image:
presentation_image = presentation.images.add_image(bullet_image)
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 200, 400, 200)
text_frame = shape.text_frame
text_frame.paragraphs.clear()
paragraph = slides.Paragraph()
paragraph.text = "Welcome to Aspose.Slides"
paragraph.paragraph_format.bullet.type = slides.BulletType.PICTURE
paragraph.paragraph_format.bullet.picture.image = presentation_image
paragraph.paragraph_format.bullet.height = 100
text_frame.paragraphs.add(paragraph)
presentation.save("picture_bullet.pptx", slides.export.SaveFormat.PPTX)
presentation.save("picture_bullet.ppt", slides.export.SaveFormat.PPT)
ایجاد فهرست چندسطحی
ParagraphFormat.depth را تنظیم کنید تا پاراگراف‌ها در سطوح مختلف فهرست قرار گیرند. سطح بالایی عمق 0 دارد.
- یک Presentation ایجاد کنید و به یک اسلاید دسترسی پیدا کنید.
- یک AutoShape اضافه کنید و پاراگراف پیش‌فرض را از TextFrame آن پاک کنید.
- چهار پاراگراف ایجاد کنید و نمادهای نقطه آن‌ها را پیکربندی کنید.
- مقدارهای ParagraphFormat.depth آن‌ها را به ترتیب
0،1،2و3تنظیم کنید. - پاراگراف‌ها را به TextFrame اضافه کنید و ارائه را ذخیره کنید.
import aspose.pydrawing as draw
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 200, 400, 200)
text_frame = shape.text_frame
text_frame.paragraphs.clear()
first_paragraph = slides.Paragraph()
first_paragraph.text = "Content"
first_paragraph.paragraph_format.bullet.type = slides.BulletType.SYMBOL
first_paragraph.paragraph_format.bullet.char = chr(0x2022)
first_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
first_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
first_paragraph.paragraph_format.depth = 0
second_paragraph = slides.Paragraph()
second_paragraph.text = "Second level"
second_paragraph.paragraph_format.bullet.type = slides.BulletType.SYMBOL
second_paragraph.paragraph_format.bullet.char = "-"
second_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
second_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
second_paragraph.paragraph_format.depth = 1
third_paragraph = slides.Paragraph()
third_paragraph.text = "Third level"
third_paragraph.paragraph_format.bullet.type = slides.BulletType.SYMBOL
third_paragraph.paragraph_format.bullet.char = chr(0x2022)
third_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
third_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
third_paragraph.paragraph_format.depth = 2
fourth_paragraph = slides.Paragraph()
fourth_paragraph.text = "Fourth level"
fourth_paragraph.paragraph_format.bullet.type = slides.BulletType.SYMBOL
fourth_paragraph.paragraph_format.bullet.char = "-"
fourth_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
fourth_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
fourth_paragraph.paragraph_format.depth = 3
text_frame.paragraphs.add(first_paragraph)
text_frame.paragraphs.add(second_paragraph)
text_frame.paragraphs.add(third_paragraph)
text_frame.paragraphs.add(fourth_paragraph)
presentation.save("multilevel_list.pptx", slides.export.SaveFormat.PPTX)
شروع شماره‌های فهرست شماره‌دار با مقادیر سفارشی
از BulletFormat.numbered_bullet_start_with برای تنظیم شمارهٔ اولیهٔ نمایش داده‌شده برای یک پاراگراف شماره‌دار استفاده کنید.
- یک Presentation ایجاد کنید و یک AutoShape به اسلایدی اضافه کنید.
- پاراگراف پیش‌فرض را از TextFrame شکل حذف کنید.
- سه پاراگراف شماره‌دار ایجاد کنید.
- برای پاراگراف‌های مربوطه، BulletFormat.numbered_bullet_start_with را به ترتیب
2،3و7تنظیم کنید. - پاراگراف‌ها را به TextFrame اضافه کنید و ارائه را ذخیره کنید.
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 200, 400, 200)
text_frame = shape.text_frame
text_frame.paragraphs.clear()
first_paragraph = slides.Paragraph()
first_paragraph.text = "Start at 2"
first_paragraph.paragraph_format.bullet.type = slides.BulletType.NUMBERED
first_paragraph.paragraph_format.bullet.numbered_bullet_start_with = 2
text_frame.paragraphs.add(first_paragraph)
second_paragraph = slides.Paragraph()
second_paragraph.text = "Start at 3"
second_paragraph.paragraph_format.bullet.type = slides.BulletType.NUMBERED
second_paragraph.paragraph_format.bullet.numbered_bullet_start_with = 3
text_frame.paragraphs.add(second_paragraph)
third_paragraph = slides.Paragraph()
third_paragraph.text = "Start at 7"
third_paragraph.paragraph_format.bullet.type = slides.BulletType.NUMBERED
third_paragraph.paragraph_format.bullet.numbered_bullet_start_with = 7
text_frame.paragraphs.add(third_paragraph)
presentation.save("custom_numbered_list.pptx", slides.export.SaveFormat.PPTX)
کنترل چیدمان پاراگراف و ویژگی‌های انتهایی
تنظیم تورفتگی خط اول
از ویژگی ParagraphFormat.indent برای کنترل تورفتگی خط اول یک پاراگراف استفاده کنید. این ویژگی فقط خط اول را نسبت به حاشیهٔ چپ پاراگراف جابه‌جا می‌کند. مقدار مثبت خط اول را به راست می‌برد، در حالی که خطوط باقی‌مانده با بدن پاراگراف هم‌راستا می‌مانند.
زمانی که نیاز به جابه‌جایی کل پاراگراف دارید، از ParagraphFormat.margin_left استفاده کنید. زمانی که فقط خط اول را می‌خواهید جابه‌جا کنید، از ParagraphFormat.indent استفاده کنید.
مثال زیر چند پاراگراف ایجاد می‌کند و مقادیر مختلف ParagraphFormat.indent را اعمال می‌کند تا نشان دهد تورفتگی خط اول چگونه بر چیدمان پاراگراف‌ها تأثیر می‌گذارد.
- یک نمونه از کلاس Presentation ایجاد کنید.
- به اسلاید هدف دسترسی پیدا کنید.
- یک AutoShape مستطیلی به اسلاید اضافه کنید.
- به TextFrame شکل دسترسی پیدا کنید و پاراگراف پیش‌فرض را حذف کنید.
- چند پاراگراف ایجاد کنید و مقادیر مختلف ParagraphFormat.indent را برای آن‌ها تنظیم کنید.
- پاراگراف‌ها را به TextFrame اضافه کنید.
- ارائهٔ تغییر یافته را ذخیره کنید.
import aspose.pydrawing as draw
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 420, 220)
shape.fill_format.fill_type = slides.FillType.NO_FILL
shape.line_format.fill_format.fill_type = slides.FillType.SOLID
shape.line_format.fill_format.solid_fill_color.color = draw.Color.gray
text_frame = shape.text_frame
text_frame.text_frame_format.autofit_type = slides.TextAutofitType.SHAPE
text_frame.paragraphs.clear()
first_paragraph = slides.Paragraph()
first_paragraph.text = "No first-line indent. Wrapped lines start at the same position as the first line."
first_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
first_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
first_paragraph.paragraph_format.margin_left = 20
first_paragraph.paragraph_format.indent = 0
second_paragraph = slides.Paragraph()
second_paragraph.text = "First-line indent of 20 points. The first line moves to the right, while wrapped lines remain aligned to the paragraph body."
second_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
second_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
second_paragraph.paragraph_format.margin_left = 20
second_paragraph.paragraph_format.indent = 20
third_paragraph = slides.Paragraph()
third_paragraph.text = "First-line indent of 40 points. This paragraph shows a larger first-line offset to make the effect easier to see."
third_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
third_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
third_paragraph.paragraph_format.margin_left = 20
third_paragraph.paragraph_format.indent = 40
text_frame.paragraphs.add(first_paragraph)
text_frame.paragraphs.add(second_paragraph)
text_frame.paragraphs.add(third_paragraph)
presentation.save("paragraph_indent.pptx", slides.export.SaveFormat.PPTX)
نتیجه:
تنظیم تورفتگی معلق
تورفتگی معلق یک چیدمان پاراگراف است که در آن خط اول به سمت چپ خطوط باقی‌مانده شروع می‌شود. در Aspose.Slides، این اثر را با ویژگی ParagraphFormat.indent ایجاد می‌کنید. مقدار indent را به عدد منفی تنظیم کنید تا خط اول نسبت به بدن پاراگراف به سمت چپ جابه‌جا شود.
در عمل، ParagraphFormat.margin_left موقعیت چپ بدن پاراگراف را تعریف می‌کند و ParagraphFormat.indent موقعیت خط اول نسبت به آن حاشیه را مشخص می‌کند. برای ایجاد تورفتگی معلق، مقدار مثبت margin_left و مقدار منفی indent تنظیم کنید.
این قالب‌بندی برای کتابشناسی‌ها، ارجاعات، ورودی‌های واژه‌نامه و سایر پاراگراف‌هایی که خطوط شکسته باید زیر بدن پاراگراف تراز شوند، مفید است.
- یک نمونه از کلاس Presentation ایجاد کنید.
- به اسلاید هدف دسترسی پیدا کنید.
- یک AutoShape مستطیلی به اسلاید اضافه کنید.
- به TextFrame شکل دسترسی پیدا کنید و پاراگراف پیش‌فرض را حذف کنید.
- پاراگراف‌ها را ایجاد کنید و برای هر پاراگراف مقدار مثبت ParagraphFormat.margin_left تنظیم کنید.
- مقدار منفی ParagraphFormat.indent تنظیم کنید تا اثر تورفتگی معلق ایجاد شود.
- پاراگراف‌ها را به TextFrame اضافه کنید.
- ارائهٔ تغییر یافته را ذخیره کنید.
import aspose.pydrawing as draw
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 420, 220)
shape.fill_format.fill_type = slides.FillType.NO_FILL
shape.line_format.fill_format.fill_type = slides.FillType.SOLID
shape.line_format.fill_format.solid_fill_color.color = draw.Color.gray
text_frame = shape.text_frame
text_frame.text_frame_format.autofit_type = slides.TextAutofitType.SHAPE
text_frame.paragraphs.clear()
first_paragraph = slides.Paragraph()
first_paragraph.text = "A hanging indent is created by combining a positive left margin with a negative indent. The first line starts to the left, while wrapped lines align with the paragraph body."
first_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
first_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
first_paragraph.paragraph_format.margin_left = 40
first_paragraph.paragraph_format.indent = -20
second_paragraph = slides.Paragraph()
second_paragraph.text = "This second example uses a deeper hanging indent so the difference between the first line and the wrapped lines is easier to compare."
second_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
second_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
second_paragraph.paragraph_format.margin_left = 60
second_paragraph.paragraph_format.indent = -30
text_frame.paragraphs.add(first_paragraph)
text_frame.paragraphs.add(second_paragraph)
presentation.save("hanging_indent.pptx", slides.export.SaveFormat.PPTX)
نتیجه:
تنظیم ویژگی‌های انتهای پاراگراف
ویژگی Paragraph.end_paragraph_portion_format قالب‌بندی علامت پایان پاراگراف را کنترل می‌کند. مثال زیر اندازهٔ قلم و فونت لاتین را به علامت پایان پاراگراف دوم اختصاص می‌دهد:
- یک Presentation بارگذاری کنید و به اسلایدی دسترسی پیدا کنید.
- یک AutoShape اضافه کنید و پاراگراف پیش‌فرض آن را پاک کنید.
- دو پاراگراف ایجاد کنید و بخش‌های متنی به آن‌ها اضافه کنید.
- یک PortionFormat برای علامت پایان پاراگراف دوم ایجاد کنید.
- مقادیر PortionFormat.font_height و PortionFormat.latin_font را تنظیم کنید.
- قالب را به Paragraph.end_paragraph_portion_format اختصاص دهید و ارائه را ذخیره کنید.
import aspose.slides as slides
with slides.Presentation("Test.pptx") as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, 200, 250)
text_frame = shape.text_frame
text_frame.paragraphs.clear()
first_paragraph = slides.Paragraph()
first_paragraph.portions.add(slides.Portion("Sample text"))
second_paragraph = slides.Paragraph()
second_paragraph.portions.add(slides.Portion("Sample text 2"))
end_paragraph_format = slides.PortionFormat()
end_paragraph_format.font_height = 48
end_paragraph_format.latin_font = slides.FontData("Times New Roman")
second_paragraph.end_paragraph_portion_format = end_paragraph_format
text_frame.paragraphs.add(first_paragraph)
text_frame.paragraphs.add(second_paragraph)
presentation.save("end_paragraph_format.pptx", slides.export.SaveFormat.PPTX)
شمارش خطوط رندر شده
برای قواعد پاراگراف که بر بسته شدن خودکار و نقطه‌گذاری در انتهای خطوط تأثیر می‌گذارند، مراجعه کنید به Control Line Breaking و Control Hanging Punctuation.
از Paragraph.get_lines_count برای شمارش خطوطی که یک پاراگراف پس از چیدمان متن اشغال می‌کند، شامل بسته شدن خودکار، استفاده کنید. این برای بررسی طول متن و چیدمان در قالب‌های ارائه مفید است.
یک پاراگراف یک مورد در TextFrame.paragraphs است و می‌تواند چندین خط رندر شده اشغال کند. شکست خط صریح درون یک پاراگراف یک خط جدید ایجاد می‌کند بدون اینکه پاراگراف دیگری ایجاد شود. بسته شدن خودکار خطوط را بر اساس عرض موجود ایجاد می‌کند بدون این که شکست‌های صریح در متن وارد شود. لذا شمارش پاراگراف‌ها یا کاراکترهای شکست خط، شمارش خطوط رندر شده را نمی‌دهد.
مثال زیر یک شکل متنی ایجاد می‌کند، خطوط آن را می‌شمارد، شکل را باریک می‌کند و سپس متن را با رشته‌ای کوتاه‌تر جایگزین می‌کند. بسته شدن فعال است و خودتنظیم غیرفعال است تا عرض شکل بسته شدن را کنترل کند بدون اینکه به طور خودکار متن را کوچک یا شکل را تغییر اندازه دهد. ابعاد شکل بر حسب پوینت هستند. در پایان، مثال یک پاراگراف دیگر اضافه می‌کند و تعداد خطوط را در تمام TextFrame جمع می‌زند.
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 400, 200)
text_frame = shape.text_frame
text_frame.text_frame_format.wrap_text = slides.NullableBool.TRUE
text_frame.text_frame_format.autofit_type = slides.TextAutofitType.NONE
paragraph = text_frame.paragraphs[0]
paragraph.paragraph_format.default_portion_format.font_height = 20
paragraph.text = "This text demonstrates how automatic wrapping changes the number of rendered lines."
print(f"Original width: {paragraph.get_lines_count()}")
shape.width = 150
print(f"Narrower shape: {paragraph.get_lines_count()}")
paragraph.text = "Short text."
print(f"Shorter text: {paragraph.get_lines_count()}")
second_paragraph = slides.Paragraph()
second_paragraph.text = "Another paragraph."
second_paragraph.paragraph_format.default_portion_format.font_height = 20
text_frame.paragraphs.add(second_paragraph)
total_line_count = 0
for current_paragraph in text_frame.paragraphs:
total_line_count += current_paragraph.get_lines_count()
print(f"Total lines in the text frame: {total_line_count}")
با این متن و این ابعاد، باریک کردن شکل تعداد خطوط را افزایش می‌دهد، در حالی که جایگزینی متن با رشته کوتاه‌تر آن را کاهش می‌دهد. شمارش دقیق می‌تواند بسته به در دسترس بودن و جایگزینی قلم، اندازهٔ قلم، حاشیه‌ها، تورفتگی، بسته شدن و تنظیمات خودتنظیم متفاوت باشد. هنگام بررسی قالب، از قلم‌ها و تنظیمات چیدمان موردنظر برای محیط هدف استفاده کنید.
تنها شمارش خطوط تعیین‌کنندهٔ سرریز متن از محفظه نیست. ارتفاع در دسترس، ارتفاع خطوط، فاصله‌گذاری پاراگراف و خطوط، و رفتار خودتنظیم نیز مهم‌اند؛ حتی یک خط می‌تواند وقتی بسته شدن غیرفعال باشد، از عرض موجود عبور کند.
واردات و صادرات محتوای پاراگراف
وارد کردن متن HTML به پاراگراف‌ها
از ParagraphCollection.add_from_html برای تبدیل نشانه‌گذاری HTML به پاراگراف‌ها و Portionها در یک TextFrame استفاده کنید.
- یک نمونه از کلاس Presentation ایجاد کنید.
- به اسلاید دسترسی پیدا کنید و یک AutoShape اضافه کنید.
- به TextFrame شکل دسترسی پیدا کنید و پاراگراف پیش‌فرض را پاک کنید.
- فایل HTML منبع را بخوانید.
- رشتهٔ HTML را به ParagraphCollection.add_from_html پاس دهید.
- ارائهٔ تغییر یافته را ذخیره کنید.
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape_width = presentation.slide_size.size.width - 20
shape_height = presentation.slide_size.size.height - 20
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, shape_width, shape_height)
shape.fill_format.fill_type = slides.FillType.NO_FILL
shape.text_frame.paragraphs.clear()
with open("file.html", "r", encoding="utf-8") as html_stream:
html = html_stream.read()
shape.text_frame.paragraphs.add_from_html(html)
presentation.save("html_text.pptx", slides.export.SaveFormat.PPTX)
صادرات متن پاراگراف به HTML
از ParagraphCollection.export_to_html برای صادرات یک بازهٔ انتخابی از پاراگراف‌ها به قالب HTML استفاده کنید.
- یک نمونه از کلاس Presentation ایجاد کنید و ارائهٔ موردنظر را بارگذاری کنید.
- به اسلاید دسترسی پیدا کنید و AutoShape حاوی متن را پیدا کنید.
- به TextFrame شکل دسترسی پیدا کنید.
- متد ParagraphCollection.export_to_html را با ایندکس پاراگراف شروع و تعداد پاراگراف‌های موردنظر برای صادرات فراخوانی کنید.
- رشتهٔ HTML برگردانده‌شده را در فایلی بنویسید.
import aspose.slides as slides
with slides.Presentation("ExportingHTMLText.pptx") as presentation:
shape = presentation.slides[0].shapes[0]
if isinstance(shape, slides.AutoShape) and shape.text_frame is not None:
paragraphs = shape.text_frame.paragraphs
html = paragraphs.export_to_html(0, paragraphs.count, None)
with open("paragraphs.html", "w", encoding="utf-8") as html_stream:
html_stream.write(html)
else:
print("The first shape is not a text shape.")
رندر یک پاراگراف به عنوان تصویر
Paragraph متد get_image را برای رندر مستقیم یک پاراگراف فراهم می‌کند. این متد یک IImage برمی‌گرداند که می‌توانید با IImage.save در یک فایل یا استریم ذخیره کنید. نیازی به رندر شکل حاوی یا برش دستی تصویر بیت‌مپ نیست.
متد get_image می‌تواند None برگرداند اگر پاراگراف در مجموعهٔ والد خود یافت نشود، مرزهای رندر معتبری نداشته باشد یا قابل رندر نباشد. قبل از ذخیره کردن نتیجه را بررسی کنید و از تصویر برگردانده‌شده به‌عنوان یک مدیر زمینه برای آزادسازی منابع استفاده کنید.
رندر یک پاراگراف با مقیاس پیش‌فرض
فرض کنیم فایل ارائه‌ای به نام sample.pptx با یک اسلاید داریم که اولین شکل آن یک جعبهٔ متن حاوی سه پاراگراف است.
مثال زیر پاراگراف دوم را در یک شکل متن عادی با مقیاس پیش‌فرض رندر می‌کند و تصویر برگردانده‌شده را در قالب PNG ذخیره می‌کند:
import aspose.slides as slides
with slides.Presentation("sample.pptx") as presentation:
shape = presentation.slides[0].shapes[0]
if isinstance(shape, slides.AutoShape) and shape.text_frame is not None and shape.text_frame.paragraphs.count > 1:
paragraph = shape.text_frame.paragraphs[1]
paragraph_image = paragraph.get_image()
if paragraph_image is not None:
with paragraph_image:
paragraph_image.save("paragraph.png", slides.ImageFormat.PNG)
else:
print("The paragraph could not be rendered.")
else:
print("The expected text shape or paragraph was not found.")
نتیجه:
رندر یک پاراگراف در سلول جدول با مقیاس‌بندی
فاکتورهای مقیاس افقی و عمودی را به get_image پاس می‌دهیم تا اندازهٔ پاراگراف رندر‌شده را کنترل کنیم. مثال زیر یک جدول ایجاد می‌کند، پاراگراف را در اولین سلول آن با دو برابر عرض و ارتفاع پیش‌فرض رندر می‌کند و نتیجه را به عنوان تصویر PNG ذخیره می‌کند:
import aspose.slides as slides
scale_x = 2
scale_y = 2
with slides.Presentation() as presentation:
slide = presentation.slides[0]
table = slide.shapes.add_table(50, 50, [300], [80])
paragraph = table.rows[0][0].text_frame.paragraphs[0]
paragraph.text = "Text in a table cell"
paragraph_image = paragraph.get_image(scale_x, scale_y)
if paragraph_image is not None:
with paragraph_image:
paragraph_image.save("table_paragraph.png", slides.ImageFormat.PNG)
else:
print("The paragraph could not be rendered.")
عامل مقیاس 1 آن محور را در اندازه پیش‌فرض پیکسل نگه می‌دارد. به‌عنوان مثال، 2 برای هر دو عامل تصویر با عرض و ارتفاع تقریباً دو برابر ابعاد پیش‌فرض ایجاد می‌کند که به چهار برابر پیکسل منجر می‌شود. عوامل بزرگتر معمولاً متن واضح‌تری برای بزرگنمایی یا خروجی با وضوح بالا تولید می‌کنند، اما مصرف حافظه و حجم فایل را نیز افزایش می‌دهند. عوامل زیر 1 تصاویر کوچکتری با جزئیات کمتر تولید می‌کنند. برای حفظ نسبت عرض به ارتفاع پاراگراف، از عوامل مساوی استفاده کنید؛ عوامل متفاوت افقی و عمودی خروجی را به طور مستقل کش می‌دهند.
رندر کردن کل شکل با Shape.get_image زمانی مفید است که خروجی باید شامل پر، مرز یا سایر زمینه‌های بصری شکل باشد. برای تصویر فقط پاراگراف، از Paragraph.get_image استفاده کنید.
سؤالات متداول
آیا می‌توانم بسته شدن خطوط را به‌صورت کامل در داخل یک TextFrame غیرفعال کنم؟
بله. TextFrameFormat.wrap_text را تنظیم کنید تا بسته شدن غیرفعال شود و خطوط در لبه‌های TextFrame شکسته نشوند.
چگونه می‌توانم مرزهای دقیق یک پاراگراف خاص بر روی اسلاید را دریافت کنم؟
از Paragraph.get_rect برای دریافت مستطیل محصور کنندهٔ پاراگراف استفاده کنید. Portion.get_rect مرزهای یک Portion تک را فراهم می‌کند.
محل کنترل تراز پاراگراف (چپ، راست، وسط یا به‌صورت توجیه‌شده) کجاست؟
ParagraphFormat.alignment یک تنظیم سطح پاراگراف است و بر کل پاراگراف اعمال می‌شود، صرف‌نظر از قالب‌بندی هر Portion. برای ترازبندی عمودی Portionهای با اندازهٔ قلم‌های متفاوت در هر خط، به Align Fonts Within a Line مراجعه کنید.
آیا می‌توانم زبان تصحیح را برای بخشی از یک پاراگراف تنظیم کنم؟
بله. برای هر Portion به‌صورت جداگانه PortionFormat.language_id را تنظیم کنید تا یک پاراگراف بتواند متن‌هایی با زبان‌های مختلف داشته باشد.