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

برای یافتن و برجستهسازی متن ثابت یا تطبیقهای عبارت منظم، به جستجو و جایگزینی متن مراجعه کنید.
تنظیم رنگ پسزمینه متن
از IParagraphFormat.getDefaultPortionFormat برای تنظیم رنگ برجستهٔ پیشفرض یک پاراگراف استفاده کنید، یا برای قسمتهای متن جداگانه از IBasePortionFormat.getHighlightColor استفاده کنید.
مثال زیر رنگ برجستهٔ خاکستری روشن را بهعنوان پیشفرض برای اولین پاراگراف تنظیم میکند. رنگهای برجستهٔ صریح در قسمتهای جداگانه بر این پیشفرض ارجحیت دارند:
import com.aspose.slides.*;
import java.awt.Color;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
IParagraph paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
// رنگ برجسته را برای تمام پاراگراف تنظیم کنید.
paragraph.getParagraphFormat().getDefaultPortionFormat().getHighlightColor().setColor(Color.LIGHT_GRAY);
presentation.save("gray_paragraph.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
نتیجه:

مثال کد زیر نشان میدهد چگونه رنگ پسزمینه را برای قسمتهای متن با قلم توپر تنظیم کنید:
import com.aspose.slides.*;
import java.awt.Color;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
IParagraph paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
for (IPortion portion : 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();
}
نتیجه:

تراز پاراگرافهای متن
از IParagraphFormat.setAlignment برای تنظیم تراز پاراگراف در داخل یک قاب متن استفاده کنید. مقدار میتواند centered، left‑aligned، right‑aligned، justified و غیره باشد.
مثال کد زیر نشان میدهد چگونه پاراگراف را به مرکز تراز کنید:
import com.aspose.slides.*;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
IParagraph paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
// تنظیم تراز پاراگراف به مرکز.
paragraph.getParagraphFormat().setAlignment(TextAlignment.Center);
presentation.save("aligned_paragraph.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
نتیجه:

تراز قلمها درون یک خط
از IParagraphFormat.setFontAlignment برای تراز عمودی قسمتهای متن با اندازههای قلم متفاوت در یک خط استفاده کنید. این تنظیم برای کل پاراگراف اعمال میشود و تراز را در هر یک از خطوط آن کنترل میکند.
مثال مستقل زیر چهار جعبهٔ متنی برچسبدار را در یک اسلاید ایجاد میکند. هر پاراگراف همان متن را با اندازههای ۱۸، ۳۶ و ۵۴ پوینت دارد و تراز قلم متفاوتی دارد. از Arial استفاده میکند، autofit و wrapping را غیرفعال میکند و قابهای متنی را به اندازهای بزرگ نگه میدارد که کافی باشد برای یک خط.
import com.aspose.slides.*;
import java.awt.Color;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
int[] alignments = { FontAlignment.Baseline, FontAlignment.Top, FontAlignment.Center, FontAlignment.Bottom };
String[] alignmentNames = { "Baseline", "Top", "Center", "Bottom" };
float[] fontSizes = { 18f, 36f, 54f };
for (int i = 0; i < alignments.length; i++) {
IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 30, 20 + i * 130, 660, 120);
shape.getFillFormat().setFillType(FillType.NoFill);
shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill);
ITextFrame textFrame = shape.getTextFrame();
textFrame.getTextFrameFormat().setAnchoringType(TextAnchorType.Top);
textFrame.getTextFrameFormat().setAutofitType(TextAutofitType.None);
textFrame.getTextFrameFormat().setWrapText(NullableBool.False);
IParagraph label = textFrame.getParagraphs().get_Item(0);
label.setText(alignmentNames[i]);
label.getParagraphFormat().setAlignment(TextAlignment.Left);
label.getParagraphFormat().getDefaultPortionFormat().setFontHeight(14);
label.getParagraphFormat().getDefaultPortionFormat().setLatinFont(new FontData("Arial"));
label.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
label.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.GRAY);
Paragraph paragraph = new Paragraph();
paragraph.getParagraphFormat().setFontAlignment(alignments[i]);
paragraph.getParagraphFormat().setAlignment(TextAlignment.Left);
paragraph.getParagraphFormat().getDefaultPortionFormat().setLatinFont(new FontData("Arial"));
paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
for (float fontSize : fontSizes) {
Portion portion = new Portion("Ag ");
portion.getPortionFormat().setFontHeight(fontSize);
paragraph.getPortions().add(portion);
}
textFrame.getParagraphs().add(paragraph);
}
presentation.save("font_alignment.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
نتیجه:

تراز قلم بر پایهٔ متریکهای قلم است، بنابراین لبههای قابل رؤیت حروف جداگانه لزوماً دقیقاً همسطح نمیشوند. این مثال شامل یک حرف بزرگ و یک descender است تا تفاوت بین تراز baseline و bottom نشان داده شود. در دسترس بودن قلم و جایگزینی، کاراکترهای استفادهشده و تفاوت در اندازههای قلم بر نتیجه تأثیر میگذارند. ابعاد قاب، حاشیهها، فاصلهٔ خطوط، wrapping و autofit نیز بر چینش تأثیر دارند؛ برای مقایسهٔ حالتها از همان قلمها و تنظیمات چیدمان استفاده کنید.
این تنظیم متفاوت از IParagraphFormat.setAlignment است که تراز افقی پاراگراف را کنترل میکند، و از ITextFrameFormat.setAnchoringType که بلوک متن را به صورت عمودی درون شکل موقعیت میدهد. قالببندی superscript و subscript از طریق IBasePortionFormat.setEscapement جایگاه قسمتها را نسبت به baseline جابهجا میکند نه اینکه تراز قلم برای خطوط پاراگراف تنظیم شود.
تنظیم شفافیت برای متن
شفافیت متن از طریق مؤلفهٔ آلفای رنگی که به IBasePortionFormat.getFillFormat اختصاص داده میشود، کنترل میشود. در مثالهای زیر، alpha = 50 مقدار آلفای ARGB در مقیاس ۰‑۲۵۵ است، نه درصد شفافیت.
مثال کد زیر نشان میدهد چطور شفافیت را به تمام پاراگراف اعمال کنید:
import com.aspose.slides.*;
import java.awt.Color;
int alpha = 50;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
IParagraph paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
// رنگ پرکننده متن را به رنگ شفاف تنظیم کنید.
paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(new Color(0, 0, 0, alpha));
presentation.save("transparent_paragraph.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
نتیجه:

کد مثال زیر نشان میدهد چطور شفافیت را به قسمتهای متن با قلم توپر اعمال کنید:
import com.aspose.slides.*;
import java.awt.Color;
int alpha = 50;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
IParagraph paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
for (IPortion portion : paragraph.getPortions()) {
if (portion.getPortionFormat().getEffective().getFontBold()) {
// شفافیت قسمت متن را تنظیم کنید.
portion.getPortionFormat().getFillFormat().setFillType(FillType.Solid);
portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(new Color(0, 0, 0, alpha));
}
}
presentation.save("transparent_text_portions.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
نتیجه:

تنظیم فاصلهٔ کاراکترها برای متن
از IBasePortionFormat.setSpacing برای گسترش یا فشردن فاصلهٔ بین کاراکترها در یک جعبهٔ متن استفاده کنید. مثالها ۳ پوینت فاصله اضافه میکنند؛ مقادیر منفی متن را فشرده میکنند.
کد جاوای زیر نمایش میدهد چطور فاصلهٔ کاراکترها را در تمام پاراگراف گسترش دهید:
import com.aspose.slides.*;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
IParagraph paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
// توجه: برای فشردهسازی فاصله کاراکترها از مقادیر منفی استفاده کنید.
paragraph.getParagraphFormat().getDefaultPortionFormat().setSpacing(3); // فاصله کاراکترها را گسترش دهید.
presentation.save("character_spacing_in_paragraph.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
نتیجه:

مثال کد زیر نمایش میدهد چطور فاصلهٔ کاراکترها را در قسمتهای متن با قلم توپر گسترش دهید:
import com.aspose.slides.*;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
IParagraph paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
for (IPortion portion : paragraph.getPortions()) {
if (portion.getPortionFormat().getEffective().getFontBold()) {
// توجه: برای فشردهسازی فاصله کاراکترها از مقادیر منفی استفاده کنید.
portion.getPortionFormat().setSpacing(3); // فاصله کاراکترها را گسترش دهید.
}
}
presentation.save("character_spacing_in_text_portions.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
نتیجه:

غیرفعالسازی Kerning برای قلمهای خاص
در برخی موارد، متن تولیدشده توسط Aspose.Slides ممکن است کمی فشردهتر از همان متن در PowerPoint به نظر برسد. این میتواند به این دلیل باشد که PowerPoint دادههای kerning را برای برخی قلمها نادیده میگیرد، حتی زمانی که قلم دارای اطلاعات kerning معتبر باشد و kerning در تنظیمات PowerPoint فعال باشد.
برای نزدیکتر شدن خروجی رندر شده به PowerPoint در این موارد، میتوانید kerning را برای قسمتهای متنی که از قلم موردنظر استفاده میکنند غیرفعال کنید. مقدار IBasePortionFormat.setKerningMinimalSize را بزرگتر از اندازهٔ واقعی قلم تنظیم کنید. این مثال نیاز به “presentation.pptx” دارد که در اولین اسلاید اولین شکل آن یک جعبهٔ متن باشد. این مثال نامهای قلم مؤثر، شامل قلمهای به ارثبرندگان، را بررسی میکند و آستانهٔ ۱۰۰ پوینت را برای قسمتهایی که از Roboto استفاده میکنند تنظیم میکند؛ این کار kerning را برای قسمتهای منطبق با سایز قلم زیر ۱۰۰ پوینت غیرفعال میکند:
import com.aspose.slides.*;
Presentation presentation = new Presentation("presentation.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
String targetFont = "Roboto";
for (IParagraph paragraph : autoShape.getTextFrame().getParagraphs()) {
for (IPortion portion : paragraph.getPortions()) {
IPortionFormatEffectiveData portionFormat = portion.getPortionFormat().getEffective();
if ((portionFormat.getLatinFont() != null &&
portionFormat.getLatinFont().getFontName().equals(targetFont)) ||
(portionFormat.getEastAsianFont() != null &&
portionFormat.getEastAsianFont().getFontName().equals(targetFont)) ||
(portionFormat.getComplexScriptFont() != null &&
portionFormat.getComplexScriptFont().getFontName().equals(targetFont))) {
portion.getPortionFormat().setKerningMinimalSize(100);
}
}
}
presentation.save("output.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
برای متنهای منطبق زیر آستانه، این تنظیم kerning را جلوگیری میکند و میتواند به همراستایی رندر Aspose.Slides با خروجی بصری PowerPoint برای قلمهای تحت تأثیر این رفتار خاص PowerPoint کمک کند.
مدیریت ویژگیهای قلم متن
ویژگیهای قلم میتوانند در سطح پاراگراف از طریق IParagraphFormat.getDefaultPortionFormat یا بر روی قسمتهای جداگانه از طریق IPortionFormat تنظیم شوند.
مثال زیر قلم پیشفرض اولین پاراگراف را به ۱۲ پوینت Times New Roman با قالببندی بولد، ایتالیک و زیرخط نقطهدار تنظیم میکند. قالببندی صریح بر قسمتهای جداگانه بر پیشفرضها ارجحیت دارد.
import com.aspose.slides.*;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
IParagraph paragraph = autoShape.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);
paragraph.getParagraphFormat().getDefaultPortionFormat().setLatinFont(new FontData("Times New Roman"));
presentation.save("font_properties_for_paragraph.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
نتیجه:

مثال زیر ۱۳ پوینت Times New Roman، قالببندی ایتالیک و زیرخط نقطهدار را بر قسمتهایی که قالببندی مؤثرشان بولد است اعمال میکند:
import com.aspose.slides.*;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
IParagraph paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
for (IPortion portion : paragraph.getPortions()) {
if (portion.getPortionFormat().getEffective().getFontBold()) {
// تنظیم ویژگیهای قلم برای قسمت متن.
portion.getPortionFormat().setFontHeight(13);
portion.getPortionFormat().setFontItalic(NullableBool.True);
portion.getPortionFormat().setFontUnderline(TextUnderlineType.Dotted);
portion.getPortionFormat().setLatinFont(new FontData("Times New Roman"));
}
}
presentation.save("font_properties_for_text_portions.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
نتیجه:

کنترل نرمالسازی ارتفاع متن
از IBasePortionFormat.setNormaliseHeight هنگام بازآفرینی تایپوگرافی قالب یا بررسی تفاوتهای ارتفاع کاراکتر استفاده کنید. در PowerPoint، فعالسازی نرمالسازی کاراکترهای منفرد را به صورت عمودی کشیده یا فشرده میکند تا ارتفاع قابل رؤیت یکنواختی درون قسمت متن داشته باشند. این تضمین نمیکند که ارتفاع متون در قلمهای مختلف برابر باشد.
مقدار ویژگی را به NullableBool.True یا False تنظیم کنید تا بهصراحت نرمالسازی را فعال یا غیرفعال کنید. NullableBool.NotDefined تنظیم محلی را خالی میگذارد تا قسمت مقدار را از پاراگراف، بهعنوان مثال از getDefaultPortionFormat به ارث ببرد. این به معنی False نیست. از IPortionFormat.getEffective و IBasePortionFormatEffectiveData.getNormaliseHeight برای دریافت مقدار بولی resolved استفاده کنید.
مثال خودکفا زیر نیاز به نصب Arial دارد. دو بلوک متن شامل همان حروف بزرگ، حروف کوچک، حروف descender و کاراکترهای لهجهدار را در ۵۴ پوینت ایجاد میکند. هر دو پاراگراف بهصورت پیشفرض نرمالسازی را فعال میکند. قسمت بالایی بهصراحت آن را غیرفعال میکند؛ قسمت پایین آن را به ارث میبرد. اندازهٔ قابها، حاشیهها و فاصلهٔ پاراگراف یکسان هستند، با wrapping و autofit غیرفعال شده تا مقایسه ثابت بماند. مثال False: false و NotDefined: true را چاپ میکند و «text_height_normalization.pptx» را ذخیره میکند.
import com.aspose.slides.*;
import java.awt.Color;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
byte[] settings = { NullableBool.False, NullableBool.NotDefined };
String[] settingNames = { "False", "NotDefined" };
for (int i = 0; i < settings.length; i++) {
IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 30, 60 + i * 200, 660, 150);
shape.getFillFormat().setFillType(FillType.NoFill);
shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill);
ITextFrame textFrame = shape.getTextFrame();
textFrame.setText("Hxgjpq ÅÉ 0123");
textFrame.getTextFrameFormat().setAutofitType(TextAutofitType.None);
textFrame.getTextFrameFormat().setWrapText(NullableBool.False);
textFrame.getTextFrameFormat().setAnchoringType(TextAnchorType.Top);
textFrame.getTextFrameFormat().setMarginTop(0);
textFrame.getTextFrameFormat().setMarginLeft(0);
IParagraph paragraph = textFrame.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);
IPortion portion = paragraph.getPortions().get_Item(0);
FontData font = new 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(settings[i]);
System.out.println(settingNames[i] + ": " + portion.getPortionFormat().getEffective().getNormaliseHeight());
}
presentation.save("text_height_normalization.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
مقایسهٔ زیر از ارائهٔ ذخیرهشده استخراج شد. ردیف بالایی نرمالسازی غیرفعال (False) دارد؛ ردیف پایین تنظیم فعال شده را به ارث میبرد (NotDefined → True). برای بازتولید این ظاهر Arial باید نصب باشد.

نرمالسازی ارتفاع کاراکتر را بدون تغییر مقدار getFontHeight که اندازهٔ قلم را به پوینت مشخص میکند، تغییر میدهد. setSpaceWithin فاصلهٔ خطوط را کنترل میکند، در حالی که setAutofitType رفتار متن یا محفظهٔ آن را هنگام تنظیم اندازه تنظیم میکند. این تنظیمات اهداف متفاوتی دارند و میتوانند بهطور مستقل بر چینش کلی تأثیر بگذارند. برای اطلاعات بیشتر دربارهٔ قالببندی پاراگراف و ارثبری، به مدیریت پاراگراف مراجعه کنید.
اعمال و حذف Strikethrough
از IBasePortionFormat.setStrikethroughType برای یک قسمت متن استفاده کنید تا اصلاحات، عبارات لغو شده یا قیمتهای قبلی را بدون حذف متن اصلی نشان دهید. آن را به TextStrikethroughType.Single یا Double تنظیم کنید تا یک یا دو خط از متن عبور کند.
برای حذف strikethrough، TextStrikethroughType.None را عبور دهید. این بهصراحت اثر را غیرفعال میکند، حتی اگر قالببندی اطراف strikethrough داشته باشد. برعکس، TextStrikethroughType.NotDefined تنظیم محلی را نامشخص میگذارد تا قسمت قالببندی را از پاراگراف به ارث ببرد. این تضمین نمیکند که strikethrough حذف شده باشد. برای خواندن قالببندی نهایی، شامل مقادیر ارثبری، از IPortionFormat.getEffective استفاده کنید.
مثال خودکفا زیر سه مقایسهٔ قیمتی ایجاد میکند. هر پاراگراف قسمتهای جداگانهای برای برچسب، قیمت قبلی و قیمت فعلی دارد، بهطوریکه فقط قیمت قبلی تحت تأثیر قرار میگیرد. ردیف اول strikethrough را اعمال و سپس حذف میکند؛ سایر ردیفها strikethrough تکخطی و دوخطی را حفظ میکنند. تغییر این تنظیم متن و قالببندیهای دیگر آن را حفظ میکند، از جمله قیمت قبلی بولد.
import com.aspose.slides.*;
import java.awt.Color;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape 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();
String[] labels = { "None: ", "Single: ", "Double: " };
for (String label : labels) {
Paragraph paragraph = new Paragraph();
paragraph.getParagraphFormat().setAlignment(TextAlignment.Left);
paragraph.getParagraphFormat().setSpaceAfter(20);
IPortionFormat format = paragraph.getParagraphFormat().getDefaultPortionFormat();
format.setFontHeight(28);
FontData font = new FontData("Arial");
format.setLatinFont(font);
format.getFillFormat().setFillType(FillType.Solid);
format.getFillFormat().getSolidFillColor().setColor(Color.BLACK);
Portion labelPortion = new Portion(label);
paragraph.getPortions().add(labelPortion);
Portion previousPrice = new Portion("$100");
previousPrice.getPortionFormat().setFontBold(NullableBool.True);
paragraph.getPortions().add(previousPrice);
Portion currentPrice = new Portion(" → $80");
paragraph.getPortions().add(currentPrice);
shape.getTextFrame().getParagraphs().add(paragraph);
}
IParagraphCollection 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();
}
نتیجه، از بالا به پایین: بدون strikethrough، strikethrough تکخطی و strikethrough دوخطی.

تنظیم چرخش متن
از ITextFrameFormat.setTextVerticalType برای تنظیم جهت پیشتعریفشدهٔ متن درون یک شکل استفاده کنید.
مثال کد زیر جهت متن در شکل را به TextVerticalType.Vertical270 تنظیم میکند که متن را ۹۰ درجه بهصورت ضد ساعتگرد میچرخاند:
import com.aspose.slides.*;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
autoShape.getTextFrame().getTextFrameFormat().setTextVerticalType(TextVerticalType.Vertical270);
presentation.save("text_rotation.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
نتیجه:

تنظیم چرخش سفارشی برای قابهای متن
از ITextFrameFormat.setRotationAngle برای تنظیم زاویهٔ چرخش سفارشی یک ITextFrame استفاده کنید.
مثال کد زیر قاب متن را به میزان ۳ درجه ساعتگرد درون شکل میچرخاند:
import com.aspose.slides.*;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
autoShape.getTextFrame().getTextFrameFormat().setRotationAngle(3);
presentation.save("custom_text_rotation.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
نتیجه:

تنظیم فاصلهٔ خطوط پاراگرافها
Aspose.Slides متدهای IParagraphFormat.setSpaceAfter، IParagraphFormat.setSpaceBefore و IParagraphFormat.setSpaceWithin را برای کنترل فاصلهٔ پاراگراف ارائه میدهد. این ویژگیها بهصورت زیر استفاده میشوند:
- برای تعیین فاصلهٔ خط بهصورت درصدی از ارتفاع خط، از مقدار مثبت استفاده کنید.
- برای تعیین فاصلهٔ خط بهصورت پوینت، از مقدار منفی استفاده کنید.
مثال زیر فاصلهٔ داخل اولین پاراگراف را به ۲۰۰٪ از ارتفاع خط (فاصلهٔ دوبرابری) تنظیم میکند:
import com.aspose.slides.*;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
IParagraph paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
paragraph.getParagraphFormat().setSpaceWithin(200);
presentation.save("line_spacing.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
نتیجه:

کنترل شکست خط
قوانین شکست خط پاراگراف در بلوکهای متنی باریک و ارائههای ترکیبی از متن لاتین و آسیای شرقی مفید هستند. متدهای زیر متعلق به IParagraphFormat هستند؛ بنابراین بر کل پاراگراف اعمال میشوند:
- setLatinLineBreak قواعد شکست خط لاتین را کنترل میکند. در متن ترکیبی، تغییر آن میتواند محل پیچیدن متن و علائم نگاری آسیای شرقی همسایه را تغییر دهد.
- setEastAsianLineBreak قواعد شکست خط آسیای شرقی را کنترل میکند، شامل محدودیتهای کاراکترها در ابتدای و انتهای خط.
این قواعد جایگزین ITextFrameFormat.setWrapText که خودکارسازی پیچیدن درون یک قاب متن را فعال میکند، نیستند؛ بلکه بر چینش تأثیر میگذارند زمانی که پیچیدن رخ میدهد؛ آنها کاراکترهای شکست خط را وارد نمیکنند. یک شکست خط صریح یک خط جدید درون پاراگراف ایجاد میکند مستقل از عرض موجود.
مثال خودکفا زیر یک بلوک متنی باریک حاوی متن چینی و لاتین ایجاد میکند. هر دو گزینهٔ شکست خط بهصورت صریح تنظیم میشوند و «line_breaking.pptx» ذخیره میشود. برای آزمایش هر قاعده، مقدار مربوطه را تغییر دهید در حالی که تنظیمات دیگر ثابت بمانند. این مثال از Arial ۲۴‑پوینت و SimSun با عرض قاب ۱۶۰‑پوینت و حاشیهٔ افقی صفر استفاده میکند. ITextFrameFormat.setAutofitType با TextAutofitType.None فراخوانی میشود تا اندازهٔ متن و ابعاد قاب ثابت بمانند.
import com.aspose.slides.*;
import java.awt.Color;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 160, 300);
shape.getFillFormat().setFillType(FillType.NoFill);
ITextFrame textFrame = shape.getTextFrame();
textFrame.getTextFrameFormat().setWrapText(NullableBool.True);
textFrame.getTextFrameFormat().setAutofitType(TextAutofitType.None);
textFrame.getTextFrameFormat().setMarginLeft(0);
textFrame.getTextFrameFormat().setMarginRight(0);
IParagraph paragraph = textFrame.getParagraphs().get_Item(0);
paragraph.setText("中文排版测试,PowerPoint 中文演示。");
IParagraphFormat format = paragraph.getParagraphFormat();
format.setAlignment(TextAlignment.Left);
format.getDefaultPortionFormat().setFontHeight(24);
FontData latinFont = new FontData("Arial");
format.getDefaultPortionFormat().setLatinFont(latinFont);
FontData eastAsianFont = new FontData("SimSun");
format.getDefaultPortionFormat().setEastAsianFont(eastAsianFont);
format.getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
format.getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
format.setLatinLineBreak(NullableBool.False);
format.setEastAsianLineBreak(NullableBool.True);
presentation.save("line_breaking.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
کنترل علائم نگارشی معلق
IParagraphFormat.setHangingPunctuation به علائم نگارشی واجد شرایط اجازه میدهد تا فراتر از لبهٔ راست خط متن Extending شود بهجای اینکه در خط بعدی قرار گیرند. این ویژگی برای کل پاراگراف اعمال میشود و متفاوت از تورفتگی معلق است.
مثال خودکفا زیر علامتگذاری معلق را در یک قاب متن ۱۰۰‑پوینتی فعال میکند و «hanging_punctuation.pptx» ذخیره مینماید. با Arial ۲۴‑پوینت و حاشیهٔ افقی صفر، نقطهٔ نهایی پس از «جمله» میماند و از لبهٔ راست متن فراتر میرود. برای مقایسه، ویژگی را به NullableBool.False تنظیم کنید: در این تنظیمات نقطه در خط جداگانهای قرار میگیرد. wrapping فعال و autofit غیرفعال شده تا عرض در دسترس ثابت بماند.
import com.aspose.slides.*;
import java.awt.Color;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 100, 200);
shape.getFillFormat().setFillType(FillType.NoFill);
ITextFrame textFrame = shape.getTextFrame();
textFrame.getTextFrameFormat().setWrapText(NullableBool.True);
textFrame.getTextFrameFormat().setAutofitType(TextAutofitType.None);
textFrame.getTextFrameFormat().setMarginLeft(0);
textFrame.getTextFrameFormat().setMarginRight(0);
IParagraph paragraph = textFrame.getParagraphs().get_Item(0);
paragraph.setText("Simple text, next sentence.");
IParagraphFormat format = paragraph.getParagraphFormat();
format.setAlignment(TextAlignment.Left);
format.getDefaultPortionFormat().setFontHeight(24);
FontData latinFont = new FontData("Arial");
format.getDefaultPortionFormat().setLatinFont(latinFont);
format.getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
format.getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
format.setHangingPunctuation(NullableBool.True);
presentation.save("hanging_punctuation.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
همهٔ علائم نگارشی میتوانند معلق شوند. شرایط قلم و چیدمان شرح دادهشده در بالا نیز برای این مقایسه اعمال میشود: تغییر قلم، عرض در دسترس، حاشیهها یا تنظیمات autofit میتواند تفاوت قابل مشاهده را حذف کند.
تنظیم نوع Autofit برای قابهای متن
ITextFrameFormat.setAutofitType تعیین میکند متن هنگام تجاوز از مرزهای محفظهٔ خود چگونه رفتار کند. از آن برای کنترل اینکه متن کوچک شود، سرریز شود یا شکل بهصورت خودکار تغییر اندازه دهد استفاده کنید. مثال زیر شکل را برای تطبیق خودکار با متن تنظیم میکند و نتیجه را در «autofit_type.pptx» ذخیره میکند.
import com.aspose.slides.*;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
autoShape.getTextFrame().getTextFrameFormat().setAutofitType(TextAutofitType.Shape);
presentation.save("autofit_type.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
برای شمارش خطوط پس از پیچیدن خودکار و مشاهدهٔ نحوهٔ تغییر عرض متن یا شکل، به Count Rendered Lines مراجعه کنید. تنها شمارش خطوط نشانگر سرریز متن نیست.
تنظیم لنگر قابهای متن
ITextFrameFormat.setAnchoringType نحوهٔ موقعیتیابى عمودی متن داخل یک شکل را تعریف میکند، برای مثال در بالا، وسط یا پایین. مثال زیر متن را به پایین اولین شکل لنگر میدهد و نتیجه را در «text_anchor.pptx» ذخیره میکند.
import com.aspose.slides.*;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
autoShape.getTextFrame().getTextFrameFormat().setAnchoringType(TextAnchorType.Bottom);
presentation.save("text_anchor.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
تنظیم تببندی متن
از IParagraphFormat.setDefaultTabSize و IParagraphFormat.getTabs برای پیکربندی توقفهای تب در یک پاراگراف استفاده کنید. مثال زیر فاصلهٔ تب پیشفرض را به ۱۰۰ پوینت تنظیم میکند و یک توقف تب چپتراز شده را در ۳۰ پوینت اضافه میکند. این تنظیمات بر متنی که شامل کاراکترهای تب است تأثیر میگذارد.
import com.aspose.slides.*;
Presentation presentation = new Presentation("sample.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
IParagraph paragraph = autoShape.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 متد IBasePortionFormat.setLanguageId را فراهم میکند که به شما اجازه میدهد زبان بازنگری یک قسمت متن را تنظیم کنید. زبان بازنگری تعیین میکند کدام زبان برای بررسی املا و گرامر در PowerPoint استفاده شود.
مثال زیر نیاز به «presentation.pptx» دارد که اولین شکل آن یک جعبهٔ متن در اولین اسلاید باشد و حداقل یک پاراگراف داشته باشد. محتویات اولین پاراگراف را با «1。» جایگزین میکند، SimSun را به عنوان قلم آن تنظیم میکند و زبان بازنگری چینی ساده (zh-CN) را اختصاص میدهد. نتیجه در «proofing_language.pptx» ذخیره میشود:
import com.aspose.slides.*;
Presentation presentation = new Presentation("presentation.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
IParagraph paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
paragraph.getPortions().clear();
FontData font = new FontData("SimSun");
Portion textPortion = new Portion();
textPortion.getPortionFormat().setComplexScriptFont(font);
textPortion.getPortionFormat().setEastAsianFont(font);
textPortion.getPortionFormat().setLatinFont(font);
// تنظیم شناسهٔ زبان بازنگری.
textPortion.getPortionFormat().setLanguageId("zh-CN");
textPortion.setText("1。");
paragraph.getPortions().add(textPortion);
presentation.save("proofing_language.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
تنظیم زبان پیشفرض
از LoadOptions.setDefaultTextLanguage برای تعریف زبان پیشفرض متنی که هنگام بارگذاری یا ایجاد ارائه ایجاد میشود استفاده کنید. مثال زیر یک ارائه با زبان پیشفرض انگلیسی امریکا ایجاد میکند، یک جعبهٔ متن اضافه میکند و en-US را برای اولین قسمت متن چاپ میکند.
import com.aspose.slides.*;
LoadOptions loadOptions = new LoadOptions();
loadOptions.setDefaultTextLanguage("en-US");
Presentation presentation = new Presentation(loadOptions);
try {
ISlide slide = presentation.getSlides().get_Item(0);
// افزودن یک شکل مستطیل جدید با متن.
IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 20, 150, 50);
shape.getTextFrame().setText("Sample text");
// بررسی زبان اولین بخش متن.
IPortion portion = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0);
System.out.println(portion.getPortionFormat().getLanguageId());
} finally {
presentation.dispose();
}
تنظیم سبک پیشفرض متن
برای اعمال قالببندی پیشفرض متن در سطح ارائه، از IPresentation.getDefaultTextStyle استفاده کنید.
مثال زیر قلم ۱۴‑پوینت بولد را بهعنوان پیشفرض برای پاراگرافهای سطح‑بالا در یک ارائهٔ جدید تنظیم میکند و آن را در «default_text_style.pptx» ذخیره میکند. متن میتواند این پیشفرضها را به ارث ببرد مگر اینکه قالببندی خاصتری آنها را نادیده بگیرد.
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
// دریافت قالب پاراگراف سطح بالایی.
IParagraphFormat paragraphFormat = presentation.getDefaultTextStyle().getLevel(0);
if (paragraphFormat != null) {
paragraphFormat.getDefaultPortionFormat().setFontHeight(14);
paragraphFormat.getDefaultPortionFormat().setFontBold(NullableBool.True);
}
presentation.save("default_text_style.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
استخراج متن با اثر All‑Caps
در PowerPoint، اعمال اثر All Caps باعث میشود متن بر روی اسلاید به صورت حروف بزرگ نمایش داده شود حتی اگر بهطور اولیه با حروف کوچک وارد شده باشد. وقتی چنین قسمتی از متن را با Aspose.Slides بازیابی میکنید، کتابخانه متن را دقیقاً همانطور که وارد شده است برمیگرداند. برای تطبیق با متنی که نمایش داده میشود، TextCapType را بررسی کنید و در صورتی که مقدار All باشد، رشتهٔ بازگرداندهشده را به حروف بزرگ تبدیل کنید.
این مثال به «sample2.pptx» نیاز دارد که اولین شکل آن یک جعبهٔ متن در اولین اسلاید باشد. اولین پاراگراف آن اولین بخش «Hello, Aspose!» را با اثر All Caps دارد، همانطور که در زیر نشان داده شده است.

کد مثال زیر نشان میدهد چگونه متن را با اثر All Caps استخراج کنید:
import com.aspose.slides.*;
Presentation presentation = new Presentation("sample2.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape autoShape = (IAutoShape)slide.getShapes().get_Item(0);
IPortion textPortion = autoShape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0);
System.out.println("Original text: " + textPortion.getText());
IPortionFormatEffectiveData textFormat = textPortion.getPortionFormat().getEffective();
if (textFormat.getTextCapType() == TextCapType.All) {
String text = textPortion.getText().toUpperCase();
System.out.println("All-Caps effect: " + text);
}
} finally {
presentation.dispose();
}
خروجی:
Original text: Hello, Aspose!
All-Caps effect: HELLO, ASPOSE!
FAQ
چگونه متن داخل جدول در یک اسلاید را ویرایش کنم؟
برای ویرایش متن داخل جدول در یک اسلاید، از ITable استفاده کنید. از طریق سلولها عبور کنید و هر سلول را از طریق ICell.getTextFrame و قالببندی پاراگراف از طریق IParagraph.getParagraphFormat بهروزرسانی کنید.
چگونه یک رنگ گرادیان به متن در یک اسلاید PowerPoint اعمال کنم؟
برای اعمال رنگ گرادیان به متن، از IBasePortionFormat.getFillFormat استفاده کنید. IFillFormat.setFillType را به FillType.Gradient تنظیم کنید و توقفهای گرادیان، جهت و شفافیت را پیکربندی کنید.
قابلی مرتبط: قالببندی متن درون اسلایدها.