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

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

مثال کد زیر نشان میدهد چگونه برای بخشهای متنی با قلم پررنگ رنگ پسزمینه تنظیم شود:
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const presentation = new aspose.slides.Presentation("sample.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
const autoShape = slide.getShapes().get_Item(0);
const paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
const portions = paragraph.getPortions();
const portionCount = portions.getCount();
for (let portionIndex = 0; portionIndex < portionCount; portionIndex++) {
const portion = portions.get_Item(portionIndex);
if (portion.getPortionFormat().getEffective().getFontBold()) {
// تنظیم رنگ برجسته برای بخش متن.
portion.getPortionFormat().getHighlightColor().setColor(java.getStaticFieldValue("java.awt.Color", "LIGHT_GRAY"));
}
}
presentation.save("gray_text_portions.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
نتیجه:

تراز پاراگرافهای متن
از ParagraphFormat.setAlignment برای تنظیم تراز پاراگراف داخل یک قاب متن استفاده کنید. مقدار میتواند مرکز، چپچین، راستچین، توجیهشده و غیره باشد.
مثال کد زیر نشان میدهد چگونه پاراگراف را به مرکز تراز کنید:
const aspose = { slides: require("aspose.slides.via.java") };
const presentation = new aspose.slides.Presentation("sample.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
const autoShape = slide.getShapes().get_Item(0);
const paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
// تنظیم تراز پاراگراف به مرکز.
paragraph.getParagraphFormat().setAlignment(aspose.slides.TextAlignment.Center);
presentation.save("aligned_paragraph.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
نتیجه:

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

تراز قلم از معیارهای متریک قلم استفاده میکند، بنابراین لبههای قابل مشاهدهٔ حروف بهدقت همخط نمیشوند. مثال شامل یک حرف بزرگ و یک descender است تا تفاوت بین تراز baseline و bottom نشان داده شود. در دسترس بودن قلم و جایگزینی، کاراکترهای استفادهشده و تفاوت اندازهٔ قلم بر نتایج تاثیر میگذارند. ابعاد قاب، حاشیهها، فاصلهٔ خطوط، پیچش و autofit نیز بر طرح نهایی تاثیر دارند؛ برای مقایسهٔ حالتها همان قلمها و تنظیمات طرح باید استفاده شوند.
این تنظیم متفاوت از ParagraphFormat.setAlignment است که تراز افقی پاراگراف را کنترل میکند و همچنین از TextFrameFormat.setAnchoringType که بلوک متن را به صورت عمودی داخل شکل موقعیت میدهد، متفاوت است. قالببندی Superscript و Subscript از طریق BasePortionFormat.setEscapement بخشهای جداگانه را نسبت به baseline جابهجا میکند نه اینکه تراز قلم برای خطوط پاراگراف تنظیم شود.
تنظیم شفافیت برای متن
شفافی متن از طریق مؤلفهٔ آلفای رنگی که به BasePortionFormat.getFillFormat اختصاص داده شده، کنترل میشود. در مثالهای زیر، alpha = 50 مقدار کانال آلفای ARGB در مقیاس ۰‑۲۵۵ است، نه درصد شفافیت.
مثال کد زیر نشان میدهد چگونه شفافیت به کل پاراگراف اعمال شود:
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const alpha = 50;
const transparentBlack = java.newInstanceSync("java.awt.Color", 0, 0, 0, alpha);
const presentation = new aspose.slides.Presentation("sample.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
const autoShape = slide.getShapes().get_Item(0);
const paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
const fillFormat = paragraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat();
// تنظیم رنگ پرکردن متن به رنگ شفاف.
fillFormat.setFillType(java.newByte(aspose.slides.FillType.Solid));
fillFormat.getSolidFillColor().setColor(transparentBlack);
presentation.save("transparent_paragraph.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
نتیجه:

مثال کد زیر نشان میدهد چگونه شفافیت به بخشهای متنی با قلم پررنگ اعمال شود:
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const alpha = 50;
const transparentBlack = java.newInstanceSync("java.awt.Color", 0, 0, 0, alpha);
const presentation = new aspose.slides.Presentation("sample.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
const autoShape = slide.getShapes().get_Item(0);
const paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
const portions = paragraph.getPortions();
const portionCount = portions.getCount();
for (let portionIndex = 0; portionIndex < portionCount; portionIndex++) {
const portion = portions.get_Item(portionIndex);
if (portion.getPortionFormat().getEffective().getFontBold()) {
const fillFormat = portion.getPortionFormat().getFillFormat();
// تنظیم شفافیت بخش متن.
fillFormat.setFillType(java.newByte(aspose.slides.FillType.Solid));
fillFormat.getSolidFillColor().setColor(transparentBlack);
}
}
presentation.save("transparent_text_portions.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
نتیجه:

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

مثال کد زیر نشان میدهد چگونه فاصله بین نویسهها در بخشهای متنی با قلم پررنگ گسترش یابد:
const aspose = { slides: require("aspose.slides.via.java") };
const presentation = new aspose.slides.Presentation("sample.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
const autoShape = slide.getShapes().get_Item(0);
const paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
const portions = paragraph.getPortions();
const portionCount = portions.getCount();
for (let portionIndex = 0; portionIndex < portionCount; portionIndex++) {
const portion = portions.get_Item(portionIndex);
if (portion.getPortionFormat().getEffective().getFontBold()) {
// نکته: برای فشردهسازی فاصلهٔ نویسهها از مقادیر منفی استفاده کنید.
portion.getPortionFormat().setSpacing(3); // گسترش فاصلهٔ نویسهها.
}
}
presentation.save("character_spacing_in_text_portions.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
نتیجه:

غیرفعالسازی کرنینگ برای قلمهای خاص
در برخی موارد، متنی که توسط Aspose.Slides رندر میشود ممکن است کمی فشردهتر از همان متن در PowerPoint بهنظر برسد. این ممکن است به این دلیل باشد که PowerPoint دادههای کرنینگ را برای برخی قلمها نادیده میگیرد، حتی اگر قلم حاوی اطلاعات کرنینگ معتبر باشد و کرنینگ در تنظیمات PowerPoint فعال باشد.
برای نزدیکتر شدن رندر به PowerPoint، میتوانید کرنینگ برای بخشهای متنی که از قلم تحتاثر استفاده میکنند غیرفعال کنید. با تنظیم BasePortionFormat.setKerningMinimalSize به مقداری بزرگتر از اندازهٔ واقعی قلم، این کار انجام میشود. این مثال نیاز به «presentation.pptx» دارد که در اولین اسلاید اولین شکل آن یک جعبه متن باشد. این مثال نامهای قلم مؤثر (از جمله قلمهای ارثبری) را بررسی میکند و آستانهٔ ۱۰۰ پوینت را برای بخشهایی که از Roboto استفاده میکنند اعمال میسازد؛ در این صورت کرنینگ برای بخشهای با اندازهٔ قلم زیر ۱۰۰ پوینت غیرفعال میشود:
const aspose = { slides: require("aspose.slides.via.java") };
const presentation = new aspose.slides.Presentation("presentation.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
const autoShape = slide.getShapes().get_Item(0);
const paragraphs = autoShape.getTextFrame().getParagraphs();
const paragraphCount = paragraphs.getCount();
const targetFont = "Roboto";
for (let paragraphIndex = 0; paragraphIndex < paragraphCount; paragraphIndex++) {
const portions = paragraphs.get_Item(paragraphIndex).getPortions();
const portionCount = portions.getCount();
for (let portionIndex = 0; portionIndex < portionCount; portionIndex++) {
const portion = portions.get_Item(portionIndex);
const portionFormat = portion.getPortionFormat().getEffective();
const latinFont = portionFormat.getLatinFont();
const eastAsianFont = portionFormat.getEastAsianFont();
const complexScriptFont = portionFormat.getComplexScriptFont();
if ((latinFont !== null && latinFont.getFontName() === targetFont) ||
(eastAsianFont !== null && eastAsianFont.getFontName() === targetFont) ||
(complexScriptFont !== null && complexScriptFont.getFontName() === targetFont)) {
portion.getPortionFormat().setKerningMinimalSize(100);
}
}
}
presentation.save("output.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
برای متنی که زیر آستانه باشد، این تنظیم از کرنینگ جلوگیری میکند و میتواند به همراستایی رندر Aspose.Slides با خروجی بصری PowerPoint برای قلمهای تحتتاثیر این رفتار خاص PowerPoint کمک کند.
مدیریت ویژگیهای قلم متن
ویژگیهای قلم میتوانند در سطح پاراگراف از طریق ParagraphFormat.getDefaultPortionFormat یا بر روی بخشهای جداگانه از طریق PortionFormat تنظیم شوند.
مثال زیر قلم پیشفرض اولین پاراگراف را به ۱۲ پوینت Times New Roman با قالببندی پررنگ، ایتالیک و زیرخط نقطهای تنظیم میکند. قالببندی صریح بر بخشهای جداگانه بر پیشفرضها اولویت دارد:
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const presentation = new aspose.slides.Presentation("sample.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
const autoShape = slide.getShapes().get_Item(0);
const paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
const defaultPortionFormat = paragraph.getParagraphFormat().getDefaultPortionFormat();
// تنظیم ویژگیهای قلم برای پاراگراف.
defaultPortionFormat.setFontHeight(12);
defaultPortionFormat.setFontBold(java.newByte(aspose.slides.NullableBool.True));
defaultPortionFormat.setFontItalic(java.newByte(aspose.slides.NullableBool.True));
defaultPortionFormat.setFontUnderline(java.newByte(aspose.slides.TextUnderlineType.Dotted));
defaultPortionFormat.setLatinFont(new aspose.slides.FontData("Times New Roman"));
presentation.save("font_properties_for_paragraph.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
نتیجه:

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

کنترل نرمالسازی ارتفاع متن
از BasePortionFormat.setNormaliseHeight هنگام بازتولید تایپوگرافی قالب یا بررسی اختلافات ارتفاع نویسه استفاده میشود. در PowerPoint، فعالسازی نرمالسازی، نویسههای جداگانه را به صورت عمودی کشیده یا فشرده میکند تا ارتفاع ظاهری یکسانی در داخل بخش متن داشته باشند. این کار تضمین نمیکند که ارتفاع متن در قلمهای مختلف برابر باشد.
مقدار را به NullableBool.True یا False تنظیم کنید تا بهصورت صریح نرمالسازی را فعال یا غیرفعال کنید. NullableBool.NotDefined تنظیم محلی را نامتعین میگذارد تا بخش مقدار ارثبری شده، مثلاً از getDefaultPortionFormat پاراگراف، را دریافت کند. این به معنای False نیست. برای دریافت مقدار Boolean حلشده از PortionFormat.getEffective و IBasePortionFormatEffectiveData.getNormaliseHeight استفاده کنید.
مثال خود-contained زیر نیاز به نصب Arial دارد. این مثال دو بلوک متن شامل حروف بزرگ، حروف کوچک، descender و کاراکترهای ترکیبی با اندازهٔ ۵۴ پوینت ایجاد میکند. هر دو پاراگراف بهصورت پیشفرض نرمالسازی را فعال میکنند. بخش بالایی صریحاً آن را غیرفعال میکند؛ بخش پایینتری مقدار ارثبری شده را دارد. ابعاد قاب، حاشیهها و فاصلهٔ پاراگراف یکسان هستند و پیچش و autofit غیرفعالاند تا مقایسه ثابت بماند. مثال False: false و NotDefined: true را چاپ میکند و سپس «text_height_normalization.pptx» را ذخیره میسازد.
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const presentation = new aspose.slides.Presentation();
try {
const slide = presentation.getSlides().get_Item(0);
const settings = [aspose.slides.NullableBool.False, aspose.slides.NullableBool.NotDefined];
const settingNames = ["False", "NotDefined"];
for (let i = 0; i < settings.length; i++) {
const shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 30, 60 + i * 200, 660, 150);
shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
shape.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
const textFrame = shape.getTextFrame();
textFrame.setText("Hxgjpq ÅÉ 0123");
textFrame.getTextFrameFormat().setAutofitType(java.newByte(aspose.slides.TextAutofitType.None));
textFrame.getTextFrameFormat().setWrapText(java.newByte(aspose.slides.NullableBool.False));
textFrame.getTextFrameFormat().setAnchoringType(java.newByte(aspose.slides.TextAnchorType.Top));
textFrame.getTextFrameFormat().setMarginTop(0);
textFrame.getTextFrameFormat().setMarginLeft(0);
const paragraph = textFrame.getParagraphs().get_Item(0);
paragraph.getParagraphFormat().setAlignment(aspose.slides.TextAlignment.Left);
paragraph.getParagraphFormat().setSpaceBefore(0);
paragraph.getParagraphFormat().setSpaceAfter(0);
paragraph.getParagraphFormat().setSpaceWithin(100);
paragraph.getParagraphFormat().getDefaultPortionFormat().setNormaliseHeight(java.newByte(aspose.slides.NullableBool.True));
const portion = paragraph.getPortions().get_Item(0);
const font = new aspose.slides.FontData("Arial");
portion.getPortionFormat().setLatinFont(font);
portion.getPortionFormat().setFontHeight(54);
portion.getPortionFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
const textColor = java.getStaticFieldValue("java.awt.Color", "BLACK");
portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(textColor);
portion.getPortionFormat().setNormaliseHeight(java.newByte(settings[i]));
console.log(settingNames[i] + ": " + portion.getPortionFormat().getEffective().getNormaliseHeight());
}
presentation.save("text_height_normalization.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
مقایسهٔ زیر از ارائهٔ ذخیرهشده استخراج شده است. ردیف بالایی نرمالسازی غیرفعال (False) دارد؛ ردیف پایینی مقدار ارثبریشده فعال (NotDefined → True) است. برای بازتولید این ظاهر Arial باید نصب باشد.

نرمالسازی ارتفاع نویسه را بدون تغییر مقدار getFontHeight که اندازهٔ قلم را به پوینت مشخص میکند، تغییر میدهد. ParagraphFormat.setSpaceWithin فاصلهٔ خطوط را کنترل میکند، در حالی که TextFrameFormat.setAutofitType نحوهٔ تنظیمات متن یا محفظهٔ آن را برای جاگذاری تعیین میکند. این تنظیمات اهداف متفاوتی دارند و میتوانند بهطور مستقل بر چیدمان کلی تاثیر بگذارند. برای جزئیات بیشتر دربارهٔ قالببندی پاراگراف و ارثبری، به مدیریت پاراگراف مراجعه کنید.
اعمال و حذف خطکشیده
از BasePortionFormat.setStrikethroughType بر یک بخش متن برای نمایش اصلاحات، عبارات لغو شده یا قیمتهای قبلی بدون حذف متن اصلی استفاده کنید. برای یک یا دو خط عبور از متن، به ترتیب از TextStrikethroughType.Single یا Double استفاده کنید.
برای حذف خطکشیده، TextStrikethroughType.None را اعمال کنید. این بهصراحت اثر را غیرفعال میکند حتی اگر قالببندی پیرامون آن خطکشیده باشد. برعکس، TextStrikethroughType.NotDefined تنظیم محلی را نامتعین میگذارد تا بخش از قالببندی ارثبری شود، مثلاً از پاراگراف. این تضمین نمیکند که خطکشیده حذف شود. برای خواندن قالببندی نهایی، شامل مقادیر ارثبری، از PortionFormat.getEffective استفاده کنید.
مثال خود-contained زیر سه مقایسه قیمت ایجاد میکند. هر پاراگراف بخشهای جداگانهای برای برچسب، قیمت قبلی و قیمت فعلی دارد، بهطوری که فقط قیمت قبلی تحت تاثیر قرار میگیرد. ردیف اول خطکشیده را اعمال و سپس حذف میکند؛ ردیفهای دیگر به ترتیب خطکشیدهٔ تک و دو خطی را حفظ میکنند. تغییر این تنظیم متن و سایر قالببندیها، از جمله پررنگ بودن قیمت قبلی، را حفظ میکند.
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const presentation = new aspose.slides.Presentation();
try {
const slide = presentation.getSlides().get_Item(0);
const shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 50, 620, 220);
shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
shape.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
shape.getTextFrame().getParagraphs().clear();
const labels = ["None: ", "Single: ", "Double: "];
for (const label of labels) {
const paragraph = new aspose.slides.Paragraph();
paragraph.getParagraphFormat().setAlignment(aspose.slides.TextAlignment.Left);
paragraph.getParagraphFormat().setSpaceAfter(20);
const format = paragraph.getParagraphFormat().getDefaultPortionFormat();
format.setFontHeight(28);
const font = new aspose.slides.FontData("Arial");
format.setLatinFont(font);
format.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
const textColor = java.getStaticFieldValue("java.awt.Color", "BLACK");
format.getFillFormat().getSolidFillColor().setColor(textColor);
const labelPortion = new aspose.slides.Portion(label);
paragraph.getPortions().add(labelPortion);
const previousPrice = new aspose.slides.Portion("$100");
previousPrice.getPortionFormat().setFontBold(java.newByte(aspose.slides.NullableBool.True));
paragraph.getPortions().add(previousPrice);
const currentPrice = new aspose.slides.Portion(" → $80");
paragraph.getPortions().add(currentPrice);
shape.getTextFrame().getParagraphs().add(paragraph);
}
const paragraphs = shape.getTextFrame().getParagraphs();
// اعمال خطکشیده، سپس بهصراحت حذف آن از اولین قیمت قبلی.
paragraphs.get_Item(0).getPortions().get_Item(1).getPortionFormat().setStrikethroughType(java.newByte(aspose.slides.TextStrikethroughType.Single));
paragraphs.get_Item(0).getPortions().get_Item(1).getPortionFormat().setStrikethroughType(java.newByte(aspose.slides.TextStrikethroughType.None));
paragraphs.get_Item(1).getPortions().get_Item(1).getPortionFormat().setStrikethroughType(java.newByte(aspose.slides.TextStrikethroughType.Single));
paragraphs.get_Item(2).getPortions().get_Item(1).getPortionFormat().setStrikethroughType(java.newByte(aspose.slides.TextStrikethroughType.Double));
presentation.save("strikethrough.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
نتیجه، از بالا به پایین: بدون خطکشیده، خطکشیدهٔ تک، و خطکشیدهٔ دو خطی.

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

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

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

کنترل شکستن خطوط
قوانین شکستن خط پاراگراف در بلوکهای متنی باریک و ارائههای ترکیبی لاتین و شرق آسیا مفید هستند. روشهای زیر متعلق به ParagraphFormat هستند و برای کل پاراگراف اعمال میشوند:
- setLatinLineBreak قوانین شکستن خط لاتین را کنترل میکند. در متن ترکیبی، تغییر آن میتواند محل پیچش متن و علامت نگارشی شرق آسیا را نیز تغییر دهد.
- setEastAsianLineBreak قوانین شکستن خط شرق آسیا را شامل محدودیتهای کاراکترهای ابتدای و انتهای خط کنترل میکند.
این قواعد جایگزین TextFrameFormat.setWrapText که پیچش خودکار داخل فریم متن را فعال میکند، نمیشوند. آنها هنگام پیچش بر طرح تأثیر میگذارند؛ کاراکترهای شکست خط را وارد نمیکنند. یک شکست خط صریح یک خط جدید داخل پاراگراف ایجاد میکند بدون توجه به عرض موجود.
مثال خود-contained زیر بلوک متنی باریکی شامل متن چینی و لاتین میسازد. هر دو گزینهٔ شکستن خط بهصورت صریح تنظیم میشوند و «line_breaking.pptx» ذخیره میشود. برای آزمایش هر قانون، مقدار مربوطه را تغییر دهید در حالی که تنظیمات دیگر ثابت میمانند. این مثال از Arial ۲۴ پوینت و SimSun با عرض فریم ۱۶۰ پوینت و حاشیهٔ افقی صفر استفاده میکند. TextFrameFormat.setAutofitType با TextAutofitType.None فراخوانی میشود تا اندازهٔ متن و ابعاد فریم ثابت بمانند.
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const presentation = new aspose.slides.Presentation();
try {
const slide = presentation.getSlides().get_Item(0);
const shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 50, 160, 300);
shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
const textFrame = shape.getTextFrame();
textFrame.getTextFrameFormat().setWrapText(java.newByte(aspose.slides.NullableBool.True));
textFrame.getTextFrameFormat().setAutofitType(java.newByte(aspose.slides.TextAutofitType.None));
textFrame.getTextFrameFormat().setMarginLeft(0);
textFrame.getTextFrameFormat().setMarginRight(0);
const paragraph = textFrame.getParagraphs().get_Item(0);
paragraph.setText("中文排版测试,PowerPoint 中文演示。");
const format = paragraph.getParagraphFormat();
format.setAlignment(aspose.slides.TextAlignment.Left);
format.getDefaultPortionFormat().setFontHeight(24);
const latinFont = new aspose.slides.FontData("Arial");
format.getDefaultPortionFormat().setLatinFont(latinFont);
const eastAsianFont = new aspose.slides.FontData("SimSun");
format.getDefaultPortionFormat().setEastAsianFont(eastAsianFont);
format.getDefaultPortionFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
const textColor = java.getStaticFieldValue("java.awt.Color", "BLACK");
format.getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(textColor);
format.setLatinLineBreak(java.newByte(aspose.slides.NullableBool.False));
format.setEastAsianLineBreak(java.newByte(aspose.slides.NullableBool.True));
presentation.save("line_breaking.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
کنترل نقطهگذاری معلق
ParagraphFormat.setHangingPunctuation اجازه میدهد علامتگذاری قابلاعلام از لبهٔ راست خط متن فراتر رود به جای اینکه در خط بعدی قرار گیرد. این تنظیم برای کل پاراگراف اعمال میشود و متفاوت از تورفتگی معلق است.
مثال خود-contained زیر نقطهگذاری معلق را در فریم متنی با عرض ۱۰۰ پوینت فعال میکند و «hanging_punctuation.pptx» را ذخیره میکند. با استفاده از Arial ۲۴ پوینت و حاشیهٔ افقی صفر، نقطهٔ انتهای جمله پس از «sentence» میماند و از لبهٔ راست متن فراتر میرود. برای مقایسه مقدار را به NullableBool.False تنظیم کنید: با این تنظیمات نقطه در یک خط جداگانه قرار میگیرد. پیچش فعال و autofit غیرفعال هستند تا عرض قابلاستفاده ثابت بماند.
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const presentation = new aspose.slides.Presentation();
try {
const slide = presentation.getSlides().get_Item(0);
const shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 50, 100, 200);
shape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
const textFrame = shape.getTextFrame();
textFrame.getTextFrameFormat().setWrapText(java.newByte(aspose.slides.NullableBool.True));
textFrame.getTextFrameFormat().setAutofitType(java.newByte(aspose.slides.TextAutofitType.None));
textFrame.getTextFrameFormat().setMarginLeft(0);
textFrame.getTextFrameFormat().setMarginRight(0);
const paragraph = textFrame.getParagraphs().get_Item(0);
paragraph.setText("Simple text, next sentence.");
const format = paragraph.getParagraphFormat();
format.setAlignment(aspose.slides.TextAlignment.Left);
format.getDefaultPortionFormat().setFontHeight(24);
const latinFont = new aspose.slides.FontData("Arial");
format.getDefaultPortionFormat().setLatinFont(latinFont);
format.getDefaultPortionFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
const textColor = java.getStaticFieldValue("java.awt.Color", "BLACK");
format.getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(textColor);
format.setHangingPunctuation(java.newByte(aspose.slides.NullableBool.True));
presentation.save("hanging_punctuation.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
هر علامت نگارشی قابلیت معلق شدن را ندارند. شرایط قلم و طرح توصیفشده در بخش کنترل شکستن خطوط نیز بر این مقایسه اعمال میشود: تغییر قلم، عرض موجود، حاشیهها یا تنظیمات autofit میتواند تفاوت قابلمشاهده را حذف کند.
تنظیم نوع خودتنظیم برای فریمهای متن
TextFrameFormat.setAutofitType تعیین میکند که وقتی متن از مرزهای محفظهٔ خود فراتر رود، چه رفتار داشته باشد. از آن برای کنترل اینکه آیا متن کوچک میشود، سرریز میشود یا شکل بهصورت خودکار تغییر اندازه میدهد استفاده کنید. مثال زیر شکل را طوری پیکربندی میکند که برای متن خود تغییر اندازه دهد و نتایج را در «autofit_type.pptx» ذخیره میکند.
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const presentation = new aspose.slides.Presentation("sample.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
const autoShape = slide.getShapes().get_Item(0);
autoShape.getTextFrame().getTextFrameFormat().setAutofitType(java.newByte(aspose.slides.TextAutofitType.Shape));
presentation.save("autofit_type.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
برای شمارش خطوط پس از پیچش خودکار و مشاهدهٔ چگونگی تغییر عرض متن یا شکل، به Count Rendered Lines مراجعه کنید. شمارش خطوط به تنهایی نشانگر سرریز شدن متن نیست.
تنظیم لنگر فریمهای متن
TextFrameFormat.setAnchoringType تعیین میکند که متن بهصورت عمودی داخل شکل در کجا ثابت شود، مثلاً در بالا، وسط یا پایین. مثال زیر متن را به پایین اولین شکل لنگر میکند و نتیجه را در «text_anchor.pptx» ذخیره میکند.
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const presentation = new aspose.slides.Presentation("sample.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
const autoShape = slide.getShapes().get_Item(0);
autoShape.getTextFrame().getTextFrameFormat().setAnchoringType(java.newByte(aspose.slides.TextAnchorType.Bottom));
presentation.save("text_anchor.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
تنظیم تببندی متن
از ParagraphFormat.setDefaultTabSize و ParagraphFormat.getTabs برای پیکربندی ایستگاههای تب در یک پاراگراف استفاده کنید. مثال زیر فاصلهٔ پیشفرض تب را به ۱۰۰ پوینت تنظیم میکند و یک ایستگاه تب چپچین را در ۳۰ پوینت اضافه میکند. این تنظیمات بر متنی که شامل کاراکترهای تب باشد تاثیر میگذارند.
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const presentation = new aspose.slides.Presentation("sample.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
const autoShape = slide.getShapes().get_Item(0);
const paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
paragraph.getParagraphFormat().setDefaultTabSize(100);
paragraph.getParagraphFormat().getTabs().add(30, java.newByte(aspose.slides.TabAlignment.Left));
presentation.save("paragraph_tabs.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
نتیجه:

تنظیم زبان بررسی
Aspose.Slides متد BasePortionFormat.setLanguageId را فراهم میکند که به شما امکان میدهد زبان بررسی برای یک بخش متنی را تنظیم کنید. زبان بررسی تعیین میکند در PowerPoint برای املا و گرامر از چه زبانی استفاده شود.
مثال زیر به «presentation.pptx» نیاز دارد که در اولین اسلاید اولین شکل یک جعبه متن باشد و حداقل یک پاراگراف داشته باشد. این مثال محتوای اولین پاراگراف را با «1。» جایگزین میکند، قلم آن را به SimSun تنظیم میکند و زبان بررسی چینی سادهشده (zh-CN) را اختصاص میدهد. سپس نتیجه را در «proofing_language.pptx» ذخیره میکند:
const aspose = { slides: require("aspose.slides.via.java") };
const presentation = new aspose.slides.Presentation("presentation.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
const autoShape = slide.getShapes().get_Item(0);
const paragraph = autoShape.getTextFrame().getParagraphs().get_Item(0);
paragraph.getPortions().clear();
const font = new aspose.slides.FontData("SimSun");
const textPortion = new aspose.slides.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", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
تنظیم زبان پیشفرض
از LoadOptions.setDefaultTextLanguage برای تعریف زبان پیشفرض متنی که هنگام بارگذاری یا ایجاد یک ارائه ساخته میشود استفاده کنید. مثال زیر ارائهای با زبان پیشفرض متن انگلیسی ایالات متحده ایجاد میکند، یک جعبه متن اضافه میکند و برای اولین بخش متنی آن en-US را چاپ میکند.
const aspose = { slides: require("aspose.slides.via.java") };
const loadOptions = new aspose.slides.LoadOptions();
loadOptions.setDefaultTextLanguage("en-US");
const presentation = new aspose.slides.Presentation(loadOptions);
try {
const slide = presentation.getSlides().get_Item(0);
// یک شکل مستطیلی جدید با متن اضافه کنید.
const shape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 20, 20, 150, 50);
shape.getTextFrame().setText("Sample text");
// زبان اولین بخش را بررسی کنید.
const portion = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0);
console.log(portion.getPortionFormat().getLanguageId());
} finally {
presentation.dispose();
}
تنظیم سبک متن پیشفرض
برای اعمال قالببندی پیشفرض متن در سطح ارائه، از Presentation.getDefaultTextStyle استفاده کنید.
مثال زیر قلم ۱۴ پوینت پررنگ را بهعنوان پیشفرض برای پاراگرافهای سطح بالایی در یک ارائهٔ جدید تنظیم میکند و آن را در «default_text_style.pptx» ذخیره میسازد. متن میتواند این پیشفرضها را ارثبری کند مگر اینکه قالببندی خاصتری آنها را بازنویسی کند.
const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");
const presentation = new aspose.slides.Presentation();
try {
// دریافت قالب پاراگراف سطح بالا.
const paragraphFormat = presentation.getDefaultTextStyle().getLevel(0);
if (paragraphFormat !== null) {
paragraphFormat.getDefaultPortionFormat().setFontHeight(14);
paragraphFormat.getDefaultPortionFormat().setFontBold(java.newByte(aspose.slides.NullableBool.True));
}
presentation.save("default_text_style.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
presentation.dispose();
}
استخراج متن با اثر تمام حروف بزرگ
در PowerPoint، اعمال اثر All Caps باعث میشود متن در اسلاید بهصورت حروف بزرگ نشان داده شود حتی اگر در ابتدا با حروف کوچک تایپ شده باشد. وقتی چنین بخشی را با Aspose.Slides استخراج میکنید، کتابخانه متن را دقیقاً همانگونه که وارد شده بازمیگرداند. برای تطبیق با متنی که نمایش داده میشود، TextCapType را بررسی کنید و در صورتی که مقدار All باشد، رشتهٔ بازگشتی را به حروف بزرگ تبدیل کنید.
این مثال به «sample2.pptx» نیاز دارد که در اولین اسلاید اولین شکل یک جعبه متن باشد. اولین پاراگراف آن اولین بخش «Hello, Aspose!» با اثر All Caps دارد، همانطور که در زیر نشان داده شده است.

مثال کد زیر نشان میدهد چگونه متن را با اثر All Caps استخراج کنید:
const aspose = { slides: require("aspose.slides.via.java") };
const presentation = new aspose.slides.Presentation("sample2.pptx");
try {
const slide = presentation.getSlides().get_Item(0);
const autoShape = slide.getShapes().get_Item(0);
const textPortion = autoShape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0);
console.log("Original text: " + textPortion.getText());
const textFormat = textPortion.getPortionFormat().getEffective();
if (textFormat.getTextCapType() === aspose.slides.TextCapType.All) {
const text = textPortion.getText().toUpperCase();
console.log("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 تنظیم کنید و ایستگاههای گرادیان، جهت و شفافیت را پیکربندی کنید.