قالببندی متن ارائه در پایتون از طریق جاوا
نمای کلی
این مقاله نشان میدهد چگونه متن در ارائههای PowerPoint و OpenDocument را با استفاده از Aspose.Slides برای Python از طریق Java قالببندی کنید. این مقاله رنگهای پسزمینه، شفافیت، فاصلهگذاری بین حروف، ویژگیهای قلم، چرخش، فاصله پاراگراف، رفتار autofit، لنگرگذاری متن، توقفگاههای تب و تنظیمات زبان را پوشش میدهد.
اگر خلاف آن ذکر نشده باشد، مثالها از sample.pptx استفاده میکنند. اولین شکل در اولین اسلاید آن یک جعبه متن است و اولین پاراگراف آن شامل متنی است که در زیر نمایش داده شده است. هر دو شاخص اسلاید و شکل به صورت صفر-محور هستند. مثالهایی که بخشهای بولد را انتخاب میکنند از قالببندی مؤثر، شامل قالببندی بولد به ارثبرده، استفاده میکنند:

برای یافتن و برجسته کردن متن دقیق یا مطابقتهای عبارت منظم، به جستجو و جایگزینی متن مراجعه کنید.
تنظیم رنگ پسزمینه متن
از ParagraphFormat.getDefaultPortionFormat برای تنظیم رنگ هایلایت پیشفرض یک پاراگراف استفاده کنید، یا برای بخشهای متنی جداگانه از BasePortionFormat.getHighlightColor استفاده کنید.
مثال زیر هایلایت خاکستری روشن را به عنوان پیشفرض برای اولین پاراگراف تنظیم میکند. رنگهای هایلایت صریح در بخشهای جداگانه نسبت به این پیشفرض اولویت دارند:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
from java.awt import Color
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
paragraph = auto_shape.getTextFrame().getParagraphs().get_Item(0)
# رنگ هایلایت را برای تمام پاراگراف تنظیم کنید.
paragraph.getParagraphFormat().getDefaultPortionFormat().getHighlightColor().setColor(Color.LIGHT_GRAY)
presentation.save("gray_paragraph.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
نتیجه:

مثال کد زیر نشان میدهد چگونه رنگ پسزمینه را برای بخشهای متنی با قلم بولد تنظیم کنید:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
from java.awt import Color
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
paragraph = auto_shape.getTextFrame().getParagraphs().get_Item(0)
for portion in paragraph.getPortions():
if portion.getPortionFormat().getEffective().getFontBold():
# رنگ هایلایت را برای بخش متن تنظیم کنید.
portion.getPortionFormat().getHighlightColor().setColor(Color.LIGHT_GRAY)
presentation.save("gray_text_portions.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
نتیجه:

تراز کردن پاراگرافهای متن
از ParagraphFormat.setAlignment برای تنظیم تراز پاراگراف درون یک فریم متن استفاده کنید. مقدار میتواند مرکز، چپتراز، راستتراز، توجیهشده و غیره باشد.
مثال کد زیر نشان میدهد چگونه پاراگراف را به مرکز تراز کنید:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat, TextAlignment
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
paragraph = auto_shape.getTextFrame().getParagraphs().get_Item(0)
# تنظیم تراز پاراگراف به مرکز.
paragraph.getParagraphFormat().setAlignment(TextAlignment.Center)
presentation.save("aligned_paragraph.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
نتیجه:

تراز کردن قلمها درون یک خط
از ParagraphFormat.setFontAlignment برای تراز عمودی بخشهای متنی با اندازههای قلم متفاوت درون یک خط استفاده کنید. این تنظیم برای تمام پاراگراف اعمال میشود و تراز در هر یک از خطوط آن را کنترل میکند.
مثال مستقل زیر چهار جعبه متن با برچسب بر روی یک اسلاید ایجاد میکند. هر پاراگراف همان متن را با اندازههای ۱۸، ۳۶ و ۵۴ پوینت دارد، با تراز قلم متفاوت. از Arial استفاده میکند، autofit و بستهبندی را غیرفعال میکند و فریمهای متن را به اندازهای بزرگ نگه میدارد که یک خط باشند.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, FontAlignment, FontData, NullableBool, Paragraph, Portion, Presentation, SaveFormat, ShapeType, TextAlignment, TextAnchorType, TextAutofitType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
alignments = [FontAlignment.Baseline, FontAlignment.Top, FontAlignment.Center, FontAlignment.Bottom]
alignment_names = ["Baseline", "Top", "Center", "Bottom"]
font_sizes = [18.0, 36.0, 54.0]
font = FontData("Arial")
for i, alignment in enumerate(alignments):
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 30, 20 + i * 130, 660, 120)
shape.getFillFormat().setFillType(FillType.NoFill)
shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill)
text_frame = shape.getTextFrame()
text_frame.getTextFrameFormat().setAnchoringType(TextAnchorType.Top)
text_frame.getTextFrameFormat().setAutofitType(TextAutofitType.None_)
text_frame.getTextFrameFormat().setWrapText(NullableBool.False_)
label = text_frame.getParagraphs().get_Item(0)
label.setText(alignment_names[i])
label.getParagraphFormat().setAlignment(TextAlignment.Left)
label.getParagraphFormat().getDefaultPortionFormat().setFontHeight(14)
label.getParagraphFormat().getDefaultPortionFormat().setLatinFont(font)
label.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid)
label.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.GRAY)
paragraph = Paragraph()
paragraph.getParagraphFormat().setFontAlignment(alignment)
paragraph.getParagraphFormat().setAlignment(TextAlignment.Left)
paragraph.getParagraphFormat().getDefaultPortionFormat().setLatinFont(font)
paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid)
paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK)
for font_size in font_sizes:
portion = Portion("Ag ")
portion.getPortionFormat().setFontHeight(font_size)
paragraph.getPortions().add(portion)
text_frame.getParagraphs().add(paragraph)
presentation.save("font_alignment.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
نتیجه:

تراز قلم از معیارهای قلم استفاده میکند، بنابراین لبههای قابل مشاهده حروف جداگانه لزوماً دقیقاً همسطح نیستند. مثال شامل یک حرف بزرگ و یک حروف پایینبر است تا تفاوت بین تراز baseline و bottom را نشان دهد. موجودی و جایگزینی قلم، کاراکترهای استفادهشده و تفاوت در اندازههای قلم بر نتیجه تأثیر میگذارند. ابعاد فریم، حاشیهها، فاصله خطوط، بستهبندی و autofit نیز بر چیدمان اثر میگذارند؛ هنگام مقایسه حالتها از همان قلمها و تنظیمات چیدمان استفاده کنید.
این تنظیم متفاوت از ParagraphFormat.setAlignment است که تراز افقی پاراگراف را کنترل میکند، و از TextFrameFormat.setAnchoringType که بلوک متن را به صورت عمودی درون شکل موقعیت میدهد. قالببندی بالانویس و زیرنویس از طریق BasePortionFormat.setEscapement بخشهای جداگانه را نسبت به baseline جابهجا میکند نه اینکه تراز قلم خطوط پاراگراف را تنظیم کند.
تنظیم شفافیت برای متن
شفافیت متن از طریق مؤلفه آلفای رنگ اختصاص داده شده به BasePortionFormat.getFillFormat کنترل میشود. در مثالهای زیر، alpha = 50 مقدار کانال آلفای ARGB در مقیاس ۰ تا ۲۵۵ است، نه درصد شفافیت.
مثال کد زیر نشان میدهد چگونه شفافیت را به تمام پاراگراف اعمال کنید:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, Presentation, SaveFormat
from java.awt import Color
alpha = 50
text_color = Color(0, 0, 0, alpha)
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
paragraph = auto_shape.getTextFrame().getParagraphs().get_Item(0)
# رنگ پر متن را به رنگ شفاف تنظیم کنید.
paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid)
paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(text_color)
presentation.save("transparent_paragraph.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
نتیجه:

مثال کد زیر نشان میدهد چگونه شفافیت را به بخشهای متنی با قلم بولد اعمال کنید:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, Presentation, SaveFormat
from java.awt import Color
alpha = 50
text_color = Color(0, 0, 0, alpha)
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
paragraph = auto_shape.getTextFrame().getParagraphs().get_Item(0)
for portion in paragraph.getPortions():
if portion.getPortionFormat().getEffective().getFontBold():
# شفافیت بخش متن را تنظیم کنید.
portion.getPortionFormat().getFillFormat().setFillType(FillType.Solid)
portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(text_color)
presentation.save("transparent_text_portions.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
نتیجه:

تنظیم فاصله حروف برای متن
از BasePortionFormat.setSpacing برای گسترش یا فشردن فاصله بین حروف در یک جعبه متن استفاده کنید. مثالها ۳ پوینت فاصله اضافه میکنند؛ مقادیر منفی متن را فشرده میسازند.
کد Python زیر نشان میدهد چگونه فاصله حروف را در تمام پاراگراف گسترش دهید:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
paragraph = auto_shape.getTextFrame().getParagraphs().get_Item(0)
# توجه: برای فشردهسازی فاصله حروف از مقادیر منفی استفاده کنید.
paragraph.getParagraphFormat().getDefaultPortionFormat().setSpacing(3) # گسترش فاصله حروف.
presentation.save("character_spacing_in_paragraph.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
نتیجه:

مثال کد زیر نشان میدهد چگونه فاصله حروف را در بخشهای متنی با قلم بولد گسترش دهید:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
paragraph = auto_shape.getTextFrame().getParagraphs().get_Item(0)
for portion in paragraph.getPortions():
if portion.getPortionFormat().getEffective().getFontBold():
# توجه: برای فشردهسازی فاصله حروف از مقادیر منفی استفاده کنید.
portion.getPortionFormat().setSpacing(3) # گسترش فاصله حروف.
presentation.save("character_spacing_in_text_portions.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
نتیجه:

غیرفعال کردن کرنینگ برای قلمهای خاص
در برخی موارد، متنی که توسط Aspose.Slides رندر میشود ممکن است کمی فشردهتر از متن مشابه در PowerPoint به نظر برسد. این میتواند به این دلیل باشد که PowerPoint ممکن است دادههای کرنینگ برای برخی قلمها را نادیده بگیرد، حتی اگر قلم حاوی اطلاعات کرنینگ معتبر باشد و کرنینگ در تنظیمات PowerPoint فعال باشد.
برای نزدیکتر کردن خروجی رندر شده به PowerPoint در این موارد، میتوانید کرنینگ را برای بخشهای متنی که از قلم تحت تأثیر استفاده میکنند غیرفعال کنید. مقدار BasePortionFormat.setKerningMinimalSize را به مقداری بزرگتر از اندازه واقعی قلم تنظیم کنید. این مثال نیاز به «presentation.pptx» دارد که یک جعبه متن به عنوان اولین شکل در اولین اسلاید داشته باشد. نامهای قلم مؤثر، شامل قلمهای به ارثبرده، بررسی میشود و برای بخشهایی که از Roboto استفاده میکنند آستانه ۱۰۰ پوینت تنظیم میشود. این کار کرنینگ را برای بخشهای مطابقتدار با اندازه قلم زیر ۱۰۰ پوینت غیرفعال میکند:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation("presentation.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
target_font = "Roboto"
for paragraph in auto_shape.getTextFrame().getParagraphs():
for portion in paragraph.getPortions():
portion_format = portion.getPortionFormat().getEffective()
fonts = (portion_format.getLatinFont(), portion_format.getEastAsianFont(), portion_format.getComplexScriptFont())
if any(font is not None and font.getFontName() == target_font for font in fonts):
portion.getPortionFormat().setKerningMinimalSize(100)
presentation.save("output.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
برای متونی که زیر آستانه هستند، این تنظیم از کرنینگ جلوگیری میکند و میتواند به همسانسازی رندر Aspose.Slides با خروجی بصری PowerPoint برای قلمهای تحت تأثیر این رفتار خاص PowerPoint کمک کند.
مدیریت ویژگیهای قلم متن
ویژگیهای قلم میتوانند در سطح پاراگراف از طریق ParagraphFormat.getDefaultPortionFormat یا در بخشهای جداگانه از طریق PortionFormat تنظیم شوند.
مثال زیر قلم پیشفرض اولین پاراگراف را به ۱۲ پوینت Times New Roman با قالببندی بولد، ایتالیک و زیرخط نقطهدار تنظیم میکند. قالببندی صریح در بخشهای جداگانه بر این پیشفرضها برتری دارد:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FontData, NullableBool, Presentation, SaveFormat, TextUnderlineType
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
paragraph = auto_shape.getTextFrame().getParagraphs().get_Item(0)
# تنظیم ویژگیهای قلم برای پاراگراف.
paragraph.getParagraphFormat().getDefaultPortionFormat().setFontHeight(12)
paragraph.getParagraphFormat().getDefaultPortionFormat().setFontBold(NullableBool.True_)
paragraph.getParagraphFormat().getDefaultPortionFormat().setFontItalic(NullableBool.True_)
paragraph.getParagraphFormat().getDefaultPortionFormat().setFontUnderline(TextUnderlineType.Dotted)
font = FontData("Times New Roman")
paragraph.getParagraphFormat().getDefaultPortionFormat().setLatinFont(font)
presentation.save("font_properties_for_paragraph.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
نتیجه:

مثال زیر ۱۳ پوینت Times New Roman، قالببندی ایتالیک و زیرخط نقطهدار را به بخشهایی که قالببندی مؤثرشان بولد است اعمال میکند:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FontData, NullableBool, Presentation, SaveFormat, TextUnderlineType
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
paragraph = auto_shape.getTextFrame().getParagraphs().get_Item(0)
for portion in paragraph.getPortions():
if portion.getPortionFormat().getEffective().getFontBold():
# ویژگیهای قلم را برای بخش متن تنظیم کنید.
portion.getPortionFormat().setFontHeight(13)
portion.getPortionFormat().setFontItalic(NullableBool.True_)
portion.getPortionFormat().setFontUnderline(TextUnderlineType.Dotted)
font = FontData("Times New Roman")
portion.getPortionFormat().setLatinFont(font)
presentation.save("font_properties_for_text_portions.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
نتیجه:

کنترل نرمالسازی ارتفاع متن
از BasePortionFormat.setNormaliseHeight هنگام بازتولید تایپوگرافی قالب یا بررسی تفاوتهای ارتفاع حروف استفاده کنید. در PowerPoint، فعالسازی نرمالسازی حروف را به صورت عمودی کشیده یا فشرده میکند تا ارتفاع قابل مشاهدهی یکسانی درون بخش متن ایجاد شود. این تضمین نمیکند که ارتفاع متن در قلمهای مختلف برابر باشد.
مقدار ویژگی را به NullableBool.True_ یا False_ تنظیم کنید تا نرمالسازی را بهصورت صریح فعال یا غیرفعال کنید. NullableBool.NotDefined تنظیم محلی را نادیده میگیرد تا بخش مقدار را به ارث ببرد، برای مثال از getDefaultPortionFormat پاراگراف. این به معنی False نیست. از PortionFormat.getEffective استفاده کنید و getNormaliseHeight را در قالببندی مؤثر دریافتشده بخوانید تا مقدار بولی نهایی را به دست آورید.
مثال مستقل زیر نیاز به نصب Arial دارد. دو بلوک متن ایجاد میکند که حروف بزرگ، حروف کوچک، حروف پایینبر و کاراکترهای لهجهدار را با ۵۴ پوینت شامل میشوند. هر دو پاراگراف بهطور پیشفرض نرمالسازی را فعال میکنند. بخش بالایی بهصورت صریح آن را غیرفعال میکند؛ بخش پایینی آن را به ارث میبرد. اندازه فریمها، حاشیهها و فاصله پاراگراف یکسان هستند و بستهبندی و autofit غیرفعالاند تا مقایسه ثابت بماند. مثال False: False و NotDefined: True را چاپ میکند، سپس «text_height_normalization.pptx» را ذخیره میکند:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, FontData, NullableBool, Presentation, SaveFormat, ShapeType, TextAlignment, TextAnchorType, TextAutofitType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
settings = [NullableBool.False_, NullableBool.NotDefined]
setting_names = ["False", "NotDefined"]
for i, setting in enumerate(settings):
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 30, 60 + i * 200, 660, 150)
shape.getFillFormat().setFillType(FillType.NoFill)
shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill)
text_frame = shape.getTextFrame()
text_frame.setText("Hxgjpq ÅÉ 0123")
text_frame.getTextFrameFormat().setAutofitType(TextAutofitType.None_)
text_frame.getTextFrameFormat().setWrapText(NullableBool.False_)
text_frame.getTextFrameFormat().setAnchoringType(TextAnchorType.Top)
text_frame.getTextFrameFormat().setMarginTop(0)
text_frame.getTextFrameFormat().setMarginLeft(0)
paragraph = text_frame.getParagraphs().get_Item(0)
paragraph.getParagraphFormat().setAlignment(TextAlignment.Left)
paragraph.getParagraphFormat().setSpaceBefore(0)
paragraph.getParagraphFormat().setSpaceAfter(0)
paragraph.getParagraphFormat().setSpaceWithin(100)
paragraph.getParagraphFormat().getDefaultPortionFormat().setNormaliseHeight(NullableBool.True_)
portion = paragraph.getPortions().get_Item(0)
font = FontData("Arial")
portion.getPortionFormat().setLatinFont(font)
portion.getPortionFormat().setFontHeight(54)
portion.getPortionFormat().getFillFormat().setFillType(FillType.Solid)
portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK)
portion.getPortionFormat().setNormaliseHeight(setting)
print(f"{setting_names[i]}: {bool(portion.getPortionFormat().getEffective().getNormaliseHeight())}")
presentation.save("text_height_normalization.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
مقایسه زیر از ارائه ذخیرهشده صادر شده است. ردیف بالا نرمالسازی غیرفعال (False) دارد؛ ردیف پایین تنظیم فعال را به ارث میبرد (NotDefined → True). برای بازتولید این ظاهر، Arial نصب باشد.

نرمالسازی ارتفاع حروف را بدون تغییر مقدار اختصاص داده شده به getFontHeight که اندازه قلم را به پوینت مشخص میکند، تغییر میدهد. پاراگراف setSpaceWithin فاصله خطوط را کنترل میکند، در حالی که فریم متن setAutofitType نحوه تنظیم متن یا محفظه آن برای مطابقت را کنترل میکند. این تنظیمات مقاصد متفاوتی دارند و میتوانند بهصورت مستقل بر چیدمان کلی تأثیر بگذارند. برای اطلاعات بیشتر درباره قالببندی پاراگراف و ارثبری، به Manage Paragraph مراجعه کنید.
اعمال و حذف خطکش
از BasePortionFormat.setStrikethroughType بر روی یک بخش متنی استفاده کنید تا اصلاحات، اصطلاحات لغو شده یا قیمتهای قبلی را بدون حذف متن اصلی نمایش دهید. برای یک یا دو خط عبور از متن، آن را به TextStrikethroughType.Single یا Double تنظیم کنید.
برای حذف خطکش، TextStrikethroughType.None_ را ارسال کنید. این بهصورت صریح اثر را غیرفعال میکند حتی اگر قالببندی اطراف خطکش را مشخص کرده باشد. در مقابل، TextStrikethroughType.NotDefined تنظیم محلی را نامشخص میگذارد و به بخش اجازه میدهد قالببندی را به ارث ببرد، برای مثال از پاراگراف. این تضمین نمیکند که خطکش حذف شود. از PortionFormat.getEffective برای خواندن قالببندی نهایی، شامل مقادیر ارثبری، استفاده کنید.
مثال مستقل زیر سه مقایسه قیمت ایجاد میکند. هر پاراگراف بخشهای جداگانهای برای برچسب، قیمت قبلی و قیمت فعلی دارد، بنابراین فقط قیمت قبلی تحت تأثیر قرار میگیرد. ردیف اول خطکش را اعمال و سپس حذف میکند؛ ردیفهای دیگر خطکش تک و دوگانه را حفظ میکنند. تغییر این تنظیم متن و سایر قالببندیهای آن، از جمله قیمت قبلی بولد، را حفظ میکند:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, FontData, NullableBool, Paragraph, Portion, Presentation, SaveFormat, ShapeType, TextAlignment, TextStrikethroughType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 620, 220)
shape.getFillFormat().setFillType(FillType.NoFill)
shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill)
shape.getTextFrame().getParagraphs().clear()
labels = ["None: ", "Single: ", "Double: "]
for label in labels:
paragraph = Paragraph()
paragraph.getParagraphFormat().setAlignment(TextAlignment.Left)
paragraph.getParagraphFormat().setSpaceAfter(20)
portion_format = paragraph.getParagraphFormat().getDefaultPortionFormat()
portion_format.setFontHeight(28)
font = FontData("Arial")
portion_format.setLatinFont(font)
portion_format.getFillFormat().setFillType(FillType.Solid)
portion_format.getFillFormat().getSolidFillColor().setColor(Color.BLACK)
label_portion = Portion(label)
paragraph.getPortions().add(label_portion)
previous_price = Portion("$100")
previous_price.getPortionFormat().setFontBold(NullableBool.True_)
paragraph.getPortions().add(previous_price)
current_price = Portion(" → $80")
paragraph.getPortions().add(current_price)
shape.getTextFrame().getParagraphs().add(paragraph)
paragraphs = shape.getTextFrame().getParagraphs()
# اعمال خطکش، سپس بهصورت صریح آن را از اولین قیمت قبلی حذف کنید.
paragraphs.get_Item(0).getPortions().get_Item(1).getPortionFormat().setStrikethroughType(TextStrikethroughType.Single)
paragraphs.get_Item(0).getPortions().get_Item(1).getPortionFormat().setStrikethroughType(TextStrikethroughType.None_)
paragraphs.get_Item(1).getPortions().get_Item(1).getPortionFormat().setStrikethroughType(TextStrikethroughType.Single)
paragraphs.get_Item(2).getPortions().get_Item(1).getPortionFormat().setStrikethroughType(TextStrikethroughType.Double)
presentation.save("strikethrough.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
نتیجه، از بالا به پایین: بدون خطکش، خطکش تک، و خطکش دوگانه.

تنظیم چرخش متن
از TextFrameFormat.setTextVerticalType برای تنظیم جهت پیشتعریفشده متن درون یک شکل استفاده کنید.
مثال کد زیر جهت متن در شکل را به TextVerticalType.Vertical270 تنظیم میکند که متن را ۹۰ درجه ضد ساعتگرد میچرخاند:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat, TextVerticalType
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
auto_shape.getTextFrame().getTextFrameFormat().setTextVerticalType(TextVerticalType.Vertical270)
presentation.save("text_rotation.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
نتیجه:

تنظیم چرخش سفارشی برای فریمهای متن
از TextFrameFormat.setRotationAngle برای تنظیم زاویه چرخش سفارشی برای یک TextFrame استفاده کنید.
مثال کد زیر فریم متن را ۳ درجه به سمت ساعتگرد درون شکل میچرخاند:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
auto_shape.getTextFrame().getTextFrameFormat().setRotationAngle(3)
presentation.save("custom_text_rotation.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
نتیجه:

تنظیم فاصله خطوط پاراگرافها
Aspose.Slides متدهای ParagraphFormat.setSpaceAfter، ParagraphFormat.setSpaceBefore و ParagraphFormat.setSpaceWithin را برای کنترل فاصله پاراگرافها ارائه میدهد. این خصوصیات بهصورت زیر استفاده میشوند:
- برای مشخص کردن فاصله خطوط بهصورت درصدی از ارتفاع خط، مقدار مثبت استفاده کنید.
- برای مشخص کردن فاصله خطوط بهصورت پوینت، مقدار منفی استفاده کنید.
مثال زیر فاصله داخلی اولین پاراگراف را به ۲۰۰٪ از ارتفاع خط (دوبل اسپیسینگ) تنظیم میکند:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
paragraph = auto_shape.getTextFrame().getParagraphs().get_Item(0)
paragraph.getParagraphFormat().setSpaceWithin(200)
presentation.save("line_spacing.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
نتیجه:

کنترل شکست خط
قواعد شکست خط پاراگراف در بلوکهای متنی باریک و ارائههایی که متن لاتین و آسیای شرقی را ترکیب میکنند مفید هستند. متدهای زیر متعلق به ParagraphFormat هستند، بنابراین بر کل پاراگراف اعمال میشوند:
- setLatinLineBreak قوانین شکست خط لاتین را کنترل میکند. در متنهای ترکیبی، تغییر آن میتواند مکان بسته شدن متن لاتین و نقطهگذاریهای همسایه آسیای شرقی را نیز تغییر دهد.
- setEastAsianLineBreak قوانین شکست خط آسیای شرقی را کنترل میکند، از جمله محدودیتهای حروف در ابتدای و انتهای خط.
این قواعد جایگزین TextFrameFormat.setWrapText نمیشوند که بستهبندی خودکار درون فریم متن را فعال میکند. آنها هنگام بسته شدن بر چیدمان تأثیر میگذارند؛ کاراکترهای شکست خط را وارد نمیکنند. یک شکست خط صریح یک خط جدید درون پاراگراف ایجاد میکند که مستقل از عرض موجود است.
مثال مستقل زیر یک بلوک متن باریک شامل متن چینی و لاتین ایجاد میکند. هر دو گزینه شکست خط را بهصورت صریح تنظیم میکند و «line_breaking.pptx» را ذخیره میکند. برای آزمایش هر یک از قوانین، مقدار مربوطه را تغییر دهید در حالی که تنظیمات دیگر ثابت میمانند. مثال از ۲۴ پوینت Arial و SimSun با عرض فریم ۱۶۰ پوینت و حاشیه افقی صفر استفاده میکند. TextFrameFormat.setAutofitType با TextAutofitType.None_ فراخوانی میشود تا اندازه متن و ابعاد فریم ثابت بمانند:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, FontData, NullableBool, Presentation, SaveFormat, ShapeType, TextAlignment, TextAutofitType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 160, 300)
shape.getFillFormat().setFillType(FillType.NoFill)
text_frame = shape.getTextFrame()
text_frame.getTextFrameFormat().setWrapText(NullableBool.True_)
text_frame.getTextFrameFormat().setAutofitType(TextAutofitType.None_)
text_frame.getTextFrameFormat().setMarginLeft(0)
text_frame.getTextFrameFormat().setMarginRight(0)
paragraph = text_frame.getParagraphs().get_Item(0)
paragraph.setText("中文排版测试,PowerPoint 中文演示。")
paragraph_format = paragraph.getParagraphFormat()
paragraph_format.setAlignment(TextAlignment.Left)
paragraph_format.getDefaultPortionFormat().setFontHeight(24)
latin_font = FontData("Arial")
paragraph_format.getDefaultPortionFormat().setLatinFont(latin_font)
east_asian_font = FontData("SimSun")
paragraph_format.getDefaultPortionFormat().setEastAsianFont(east_asian_font)
paragraph_format.getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid)
paragraph_format.getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK)
paragraph_format.setLatinLineBreak(NullableBool.False_)
paragraph_format.setEastAsianLineBreak(NullableBool.True_)
presentation.save("line_breaking.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
کنترل نقطهگذاری معلق
ParagraphFormat.setHangingPunctuation به نقطهگذاریهای مجاز اجازه میدهد تا از لبه راست خط متن فراتر روند بهجای اینکه در خط بعدی قرار بگیرند. این تنظیم برای کل پاراگراف اعمال میشود و متفاوت از تورفتگی معلق است.
مثال مستقل زیر نقطهگذاری معلق را در فریم متن ۱۰۰ پوینتعریض فعال میکند و «hanging_punctuation.pptx» را ذخیره میکند. با ۲۴ پوینت Arial و حاشیه افقی صفر، نقطه انتهایی پس از «sentence» میماند و از لبه راست متن عبور میکند. برای مقایسه، ویژگی را به NullableBool.False_ تنظیم کنید: با این تنظیمات، نقطه در خط جداگانهای قرار میگیرد. بستهبندی فعال و autofit غیرفعال است تا عرض موجود ثابت بماند:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, FontData, NullableBool, Presentation, SaveFormat, ShapeType, TextAlignment, TextAutofitType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 100, 200)
shape.getFillFormat().setFillType(FillType.NoFill)
text_frame = shape.getTextFrame()
text_frame.getTextFrameFormat().setWrapText(NullableBool.True_)
text_frame.getTextFrameFormat().setAutofitType(TextAutofitType.None_)
text_frame.getTextFrameFormat().setMarginLeft(0)
text_frame.getTextFrameFormat().setMarginRight(0)
paragraph = text_frame.getParagraphs().get_Item(0)
paragraph.setText("Simple text, next sentence.")
paragraph_format = paragraph.getParagraphFormat()
paragraph_format.setAlignment(TextAlignment.Left)
paragraph_format.getDefaultPortionFormat().setFontHeight(24)
latin_font = FontData("Arial")
paragraph_format.getDefaultPortionFormat().setLatinFont(latin_font)
paragraph_format.getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid)
paragraph_format.getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK)
paragraph_format.setHangingPunctuation(NullableBool.True_)
presentation.save("hanging_punctuation.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
هر نقطهگذاری نمیتواند معلق باشد. شرایط قلم و چیدمان که در بالا توضیح داده شد نیز برای این مقایسه اعمال میشوند: تغییر قلم، عرض موجود، حاشیهها یا تنظیمات autofit میتواند تفاوت قابل مشاهده را حذف کند.
تنظیم نوع Autofit برای فریمهای متن
TextFrameFormat.setAutofitType تعیین میکند متن هنگام عبور از مرزهای محفظه چگونه رفتار کند. از آن برای کنترل اینکه متن کوچک شود، سرریز شود یا بهصورت خودکار شکل را تغییر اندازه دهد استفاده کنید. مثال زیر شکل را طوری تنظیم میکند که برای متن آن اندازهاش را تغییر دهد و نتیجه را در «autofit_type.pptx» ذخیره میکند:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat, TextAutofitType
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
auto_shape.getTextFrame().getTextFrameFormat().setAutofitType(TextAutofitType.Shape)
presentation.save("autofit_type.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
برای شمارش خطوط پس از بستهبندی خودکار و مشاهده اینکه چگونه عرض متن یا شکل نتیجه را تغییر میدهد، به Count Rendered Lines مراجعه کنید. شمارش خطوط به تنهایی نشاندهنده سرریز شدن متن از محفظه نیست.
تنظیم لنگر فریمهای متن
TextFrameFormat.setAnchoringType تعیین میکند متن بهصورت عمودی داخل یک شکل چگونه موقعیتگیری کند، مثلاً در بالا، وسط یا پایین. مثال زیر متن را به پایین اولین شکل لنگر میکند و نتیجه را در «text_anchor.pptx» ذخیره میکند:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat, TextAnchorType
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
auto_shape.getTextFrame().getTextFrameFormat().setAnchoringType(TextAnchorType.Bottom)
presentation.save("text_anchor.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
تنظیم تببندی متن
از ParagraphFormat.setDefaultTabSize و ParagraphFormat.getTabs برای پیکربندی توقفگاههای تب در یک پاراگراف استفاده کنید. مثال زیر فاصله تب پیشفرض را به ۱۰۰ پوینت تنظیم میکند و یک توقفگاه تب چپتراز در ۳۰ پوینت اضافه میکند. این تنظیمات بر متنی که حاوی کاراکترهای تب است تأثیر میگذارند:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat, TabAlignment
presentation = Presentation("sample.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
paragraph = auto_shape.getTextFrame().getParagraphs().get_Item(0)
paragraph.getParagraphFormat().setDefaultTabSize(100)
paragraph.getParagraphFormat().getTabs().add(30, TabAlignment.Left)
presentation.save("paragraph_tabs.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
نتیجه:

تنظیم زبان تصحیح
Aspose.Slides متد BasePortionFormat.setLanguageId را ارائه میدهد که به شما امکان تنظیم زبان تصحیح برای یک بخش متنی را میدهد. زبان تصحیح زبانی را که برای بررسی املا و دستور زبان در PowerPoint استفاده میشود تعیین میکند.
مثال زیر نیاز به «presentation.pptx» دارد که جعبه متنی بهعنوان اولین شکل در اولین اسلاید داشته باشد و حداقل یک پاراگراف داشته باشد. محتوای اولین پاراگراف را با «1।» جایگزین میکند، SimSun را به عنوان قلم تنظیم میکند و زبان تصحیح چینی ساده (zh-CN) را اختصاص میدهد. نتیجه را در «proofing_language.pptx» ذخیره میکند:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FontData, Portion, Presentation, SaveFormat
presentation = Presentation("presentation.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
paragraph = auto_shape.getTextFrame().getParagraphs().get_Item(0)
paragraph.getPortions().clear()
font = FontData("SimSun")
text_portion = Portion()
text_portion.getPortionFormat().setComplexScriptFont(font)
text_portion.getPortionFormat().setEastAsianFont(font)
text_portion.getPortionFormat().setLatinFont(font)
# شناسه زبان تصحیح را تنظیم کنید.
text_portion.getPortionFormat().setLanguageId("zh-CN")
text_portion.setText("1。")
paragraph.getPortions().add(text_portion)
presentation.save("proofing_language.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
تنظیم زبان پیشفرض
از LoadOptions.setDefaultTextLanguage برای تعریف زبان پیشفرض متنهای ایجاد شده هنگام بارگذاری یا ساخت یک ارائه استفاده کنید. مثال زیر ارائهای با زبان پیشفرض متن انگلیسی ایالات متحده ایجاد میکند، یک جعبه متن اضافه میکند و en-US را برای اولین بخش متن آن چاپ میکند:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import LoadOptions, Presentation, ShapeType
load_options = LoadOptions()
load_options.setDefaultTextLanguage("en-US")
presentation = Presentation(load_options)
try:
slide = presentation.getSlides().get_Item(0)
# یک شکل مستطیل با متن اضافه کنید.
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 20, 150, 50)
shape.getTextFrame().setText("Sample text")
# زبان اولین بخش متن را بررسی کنید.
portion = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0)
print(portion.getPortionFormat().getLanguageId())
finally:
presentation.dispose()
تنظیم سبک متن پیشفرض
برای اعمال قالببندی متن پیشفرض در سطح ارائه، از Presentation.getDefaultTextStyle استفاده کنید.
مثال زیر قلم بولد ۱۴ پوینت را بهعنوان پیشفرض برای پاراگرافهای سطح بالایی در یک ارائه جدید تنظیم میکند و آن را در «default_text_style.pptx» ذخیره میکند. متن میتواند این پیشفرضها را به ارث ببرد مگر اینکه قالببندی خاصتری آنها را بازنویسی کند:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import NullableBool, Presentation, SaveFormat
presentation = Presentation()
try:
# دریافت قالب پاراگراف سطح بالایی.
paragraph_format = presentation.getDefaultTextStyle().getLevel(0)
if paragraph_format is not None:
paragraph_format.getDefaultPortionFormat().setFontHeight(14)
paragraph_format.getDefaultPortionFormat().setFontBold(NullableBool.True_)
presentation.save("default_text_style.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
استخراج متن با اثر تمام حروف بزرگ
در PowerPoint، اعمال افکت All Caps باعث میشود متن روی اسلاید بهصورت حروف بزرگ نمایش داده شود حتی اگر بهصورت حروف کوچک وارد شده باشد. هنگامی که چنین بخشی از متن را با Aspose.Slides بازیابی میکنید، کتابخانه متن را دقیقاً همانگونه که وارد شده است بر میگرداند. برای همخوانی با متن نمایش دادهشده، TextCapType را بررسی کنید و هنگامیکه مقدار All باشد، رشته بازگشتی را به حروف بزرگ تبدیل کنید.
این مثال نیاز به «sample2.pptx» دارد که جعبه متنی بهعنوان اولین شکل در اولین اسلاید داشته باشد. اولین بخش اولین پاراگراف آن شامل «Hello, Aspose!» با افکت All Caps اعمالشده است، همانطور که در زیر نشان داده شده است:

مثال کد زیر نشان میدهد چگونه متن با افکت All Caps استخراج شود:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, TextCapType
presentation = Presentation("sample2.pptx")
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().get_Item(0)
text_portion = auto_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0)
print("Original text: " + str(text_portion.getText()))
text_format = text_portion.getPortionFormat().getEffective()
if text_format.getTextCapType() == TextCapType.All:
text = str(text_portion.getText()).upper()
print("All-Caps effect: " + text)
finally:
presentation.dispose()
خروجی:
Original text: Hello, Aspose!
All-Caps effect: HELLO, ASPOSE!
پرسشهای متداول
چگونه متن در جدول یک اسلاید را ویرایش کنم؟
برای ویرایش متن در جدول یک اسلاید، از Table استفاده کنید. از طریق سلولها مرور کنید و هر سلول را با Cell.getTextFrame بهروزرسانی کنید و قالببندی پاراگراف را با Paragraph.getParagraphFormat تنظیم نمایید.
چگونه یک رنگ گرادیان به متن در یک اسلاید PowerPoint اعمال کنم؟
برای اعمال رنگ گرادیان به متن، از BasePortionFormat.getFillFormat استفاده کنید. مقدار FillFormat.setFillType را به FillType.Gradient تنظیم کنید و نقاط گرادیان، جهت و شفافیت را پیکربندی نمایید.