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

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

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

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

تراز قلمها درون یک خط
از ParagraphFormat::setFontAlignment برای تراز عمودی بخشهای متنی با اندازههای قلم متفاوت درون یک خط استفاده کنید. این تنظیم برای تمام پاراگراف اعمال میشود و تراز را در هر یک از خطوط آن کنترل میکند.
مثال خودکفای زیر چهار جعبه متن برچسبدار را در یک اسلاید ایجاد میکند. هر پاراگراف همان متن را در اندازههای ۱۸، ۳۶ و ۵۴ نقطه دارد، با تراز قلم متفاوت. از Arial استفاده میکند، autofit و wrapping را غیرفعال میکند و چارچوبهای متن را به اندازهای بزرگ میگذارد که یک خط را بگنجاند.
use aspose\slides\FillType;
use aspose\slides\FontAlignment;
use aspose\slides\FontData;
use aspose\slides\NullableBool;
use aspose\slides\Paragraph;
use aspose\slides\Portion;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
use aspose\slides\TextAlignment;
use aspose\slides\TextAnchorType;
use aspose\slides\TextAutofitType;
$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$alignments = [FontAlignment::Baseline, FontAlignment::Top, FontAlignment::Center, FontAlignment::Bottom];
$alignmentNames = ["Baseline", "Top", "Center", "Bottom"];
$fontSizes = [18, 36, 54];
$font = new FontData("Arial");
$gray = java("java.awt.Color")->GRAY;
$black = java("java.awt.Color")->BLACK;
for ($i = 0; $i < count($alignments); $i++) {
$shape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 30, 20 + $i * 130, 660, 120);
$shape->getFillFormat()->setFillType(FillType::NoFill);
$shape->getLineFormat()->getFillFormat()->setFillType(FillType::NoFill);
$textFrame = $shape->getTextFrame();
$textFrame->getTextFrameFormat()->setAnchoringType(TextAnchorType::Top);
$textFrame->getTextFrameFormat()->setAutofitType(TextAutofitType::None);
$textFrame->getTextFrameFormat()->setWrapText(NullableBool::False);
$label = $textFrame->getParagraphs()->get_Item(0);
$label->setText($alignmentNames[$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($gray);
$paragraph = new Paragraph();
$paragraph->getParagraphFormat()->setFontAlignment($alignments[$i]);
$paragraph->getParagraphFormat()->setAlignment(TextAlignment::Left);
$paragraph->getParagraphFormat()->getDefaultPortionFormat()->setLatinFont($font);
$paragraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
$paragraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor($black);
foreach ($fontSizes as $fontSize) {
$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 نیز بر چیدمان تأثیر دارند؛ برای مقایسهٔ حالتها از همان قلمها و تنظیمات چیدمان استفاده کنید.
این تنظیم متفاوت از ParagraphFormat::setAlignment است که تراز افقی پاراگراف را کنترل میکند، و از TextFrameFormat::setAnchoringType که بلوک متن را عمودی درون شکل موقعیت میدهد. قالببندی superscript و subscript از طریق BasePortionFormat::setEscapement بخشهای منفرد را نسبت به baseline جابهجا میکند، نه اینکه تراز قلم برای خطوط پاراگراف تنظیم شود.
تنظیم شفافیت برای متن
شفافیت متن از طریق مؤلفهٔ آلفا رنگی که به BasePortionFormat::getFillFormat اختصاص داده میشود، کنترل میشود. در مثالهای زیر، alpha = 50 مقدار کانال آلفای ARGB در مقیاس ۰‑۲۵۵ است، نه درصد شفافیت.
مثال کد زیر نشان میدهد چگونه شفافیت را به تمام پاراگراف اعمال کنید:
use aspose\slides\FillType;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$alpha = 50;
$presentation = new Presentation("sample.pptx");
try {
$slide = $presentation->getSlides()->get_Item(0);
$autoShape = $slide->getShapes()->get_Item(0);
$paragraph = $autoShape->getTextFrame()->getParagraphs()->get_Item(0);
$fillFormat = $paragraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat();
// رنگ پر کردن متن را به یک رنگ شفاف تنظیم کنید.
$fillFormat->setFillType(FillType::Solid);
$transparentColor = new Java("java.awt.Color", 0, 0, 0, $alpha);
$fillFormat->getSolidFillColor()->setColor($transparentColor);
$presentation->save("transparent_paragraph.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
نتیجه:

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

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

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

مثال زیر ۱۳ پوینت Times New Roman، قالببندی ایتالیک و زیرخط نقطهدار را به بخشهایی که قالببندی مؤثر آنها بولد است اعمال میکند:
use aspose\slides\FontData;
use aspose\slides\NullableBool;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\TextUnderlineType;
$presentation = new Presentation("sample.pptx");
try {
$slide = $presentation->getSlides()->get_Item(0);
$autoShape = $slide->getShapes()->get_Item(0);
$paragraph = $autoShape->getTextFrame()->getParagraphs()->get_Item(0);
$font = new FontData("Times New Roman");
$portionCount = java_values($paragraph->getPortions()->getCount());
for ($portionIndex = 0; $portionIndex < $portionCount; $portionIndex++) {
$portion = $paragraph->getPortions()->get_Item($portionIndex);
if (java_values($portion->getPortionFormat()->getEffective()->getFontBold())) {
// خصوصیات قلم را برای بخش متن تنظیم کنید.
$portionFormat = $portion->getPortionFormat();
$portionFormat->setFontHeight(13);
$portionFormat->setFontItalic(NullableBool::True);
$portionFormat->setFontUnderline(TextUnderlineType::Dotted);
$portionFormat->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 در دادههای قالببندی مؤثر بهدست آمده، مقدار Boolean حلشده را دریافت کنید.
مثال خودکفای زیر برای اجرا نیاز به نصب Arial دارد. دو بلوک متن حاوی همان حروف بزرگ، حروف کوچک، descenderها و حروف معترض در ۵۴ پوینت ایجاد میکند. هر دو پاراگراف بهطور پیشفرض نرمالسازی فعال دارند. بخش بالایی به صراحت آن را غیرفعال میکند؛ پایینتری آن را ارث میبرد. ابعاد چارچوب، حاشیهها و فاصله پاراگراف یکسان هستند و wrapping و autofit غیرفعال است تا مقایسه ثابت بماند. مثال False: false و NotDefined: true چاپ میکند، سپس «text_height_normalization.pptx» را ذخیره میکند.
use aspose\slides\FillType;
use aspose\slides\FontData;
use aspose\slides\NullableBool;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
use aspose\slides\TextAlignment;
use aspose\slides\TextAnchorType;
use aspose\slides\TextAutofitType;
$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$settings = [NullableBool::False, NullableBool::NotDefined];
$settingNames = ["False", "NotDefined"];
for ($i = 0; $i < count($settings); $i++) {
$shape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 30, 60 + $i * 200, 660, 150);
$shape->getFillFormat()->setFillType(FillType::NoFill);
$shape->getLineFormat()->getFillFormat()->setFillType(FillType::NoFill);
$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);
$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);
$portion = $paragraph->getPortions()->get_Item(0);
$font = new FontData("Arial");
$portion->getPortionFormat()->setLatinFont($font);
$portion->getPortionFormat()->setFontHeight(54);
$portion->getPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
$black = java("java.awt.Color")->BLACK;
$portion->getPortionFormat()->getFillFormat()->getSolidFillColor()->setColor($black);
$portion->getPortionFormat()->setNormaliseHeight($settings[$i]);
$normaliseHeight = java_values($portion->getPortionFormat()->getEffective()->getNormaliseHeight());
echo $settingNames[$i], ": ", $normaliseHeight ? "true" : "false", PHP_EOL;
}
$presentation->save("text_height_normalization.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
مقایسهٔ زیر از ارائهٔ ذخیرهشده استخراج شده است. ردیف بالایی نرمالسازی غیرفعال (False) دارد؛ ردیف پایینی مقدار فعال را ارث میبرد (NotDefined → True). برای بازآفرینی این ظاهر Arial نصب شده باشد.

نرمالسازی ارتفاع کاراکترها را بدون تغییر مقدار getFontHeight که اندازهٔ قلم را به پوینت مشخص میکند، تغییر میدهد. ParagraphFormat::setSpaceWithin فاصله خطوط را کنترل میکند، در حالی که TextFrameFormat::setAutofitType نحوهٔ تنظیم متن یا کانتینر آن را برای جایگذاری تعیین میکند. این تنظیمات اهداف متفاوتی دارند و میتوانند بهصورت مستقل طرح کلی را تحت تأثیر قرار دهند. برای اطلاعات بیشتر دربارهٔ قالببندی پاراگراف و وراثت، به مدیریت پاراگراف مراجعه کنید.
اعمال و حذف خطخطی (Strikethrough)
از BasePortionFormat::setStrikethroughType روی یک بخش متنی استفاده کنید تا اصلاحات، عبارات لغو‑شده یا قیمتهای قبلی را بدون حذف متن اصلی نمایش دهید. برای یک یا دو خط عبور از متن، بهترتیب از TextStrikethroughType::Single یا Double استفاده کنید.
برای حذف خطخطی، TextStrikethroughType::None را پاس بدهید. این بهصورت صریح اثر را غیرفعال میکند، حتی اگر قالببندی اطراف خطخطی باشد. برعکس، TextStrikethroughType::NotDefined تنظیم محلی را تعریفنشده میگذارد و اجازه میدهد بخش قالببندی را از مثالاً از پاراگراف ارثبری کند. این تضمین نمیکند که خطخطی حذف شود. برای خواندن قالببندی نتیجه شامل مقادیر ارثبریشده، از PortionFormat::getEffective استفاده کنید.
مثال خودکفای زیر سه مقایسهٔ قیمت ایجاد میکند. هر پاراگراف بخشهای جداگانهای برای برچسب، قیمت قبلی و قیمت فعلی دارد، بهطوری که فقط قیمت قبلی تحت تأثیر قرار میگیرد. ردیف اول خطخطی را اعمال و سپس حذف میکند؛ ردیفهای دیگر به ترتیب یک خطخطی تک و دوخطی حفظ میشوند. تغییر این تنظیم متن و سایر قالببندیهای آن، از جمله بولد بودن قیمت قبلی، را حفظ میکند.
use aspose\slides\FillType;
use aspose\slides\FontData;
use aspose\slides\NullableBool;
use aspose\slides\Paragraph;
use aspose\slides\Portion;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
use aspose\slides\TextAlignment;
use aspose\slides\TextStrikethroughType;
$presentation = new 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: " ];
foreach ($labels as $label) {
$paragraph = new Paragraph();
$paragraph->getParagraphFormat()->setAlignment(TextAlignment::Left);
$paragraph->getParagraphFormat()->setSpaceAfter(20);
$format = $paragraph->getParagraphFormat()->getDefaultPortionFormat();
$format->setFontHeight(28);
$font = new FontData("Arial");
$format->setLatinFont($font);
$format->getFillFormat()->setFillType(FillType::Solid);
$blackColor = java("java.awt.Color")->BLACK;
$format->getFillFormat()->getSolidFillColor()->setColor($blackColor);
$labelPortion = new Portion($label);
$paragraph->getPortions()->add($labelPortion);
$previousPrice = new Portion("$100");
$previousPrice->getPortionFormat()->setFontBold(NullableBool::True);
$paragraph->getPortions()->add($previousPrice);
$currentPrice = new Portion(" → $80");
$paragraph->getPortions()->add($currentPrice);
$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 تنظیم میکند که متن را ۹۰ درجه پادساعتگرد میچرخاند:
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\TextVerticalType;
$presentation = new Presentation("sample.pptx");
try {
$slide = $presentation->getSlides()->get_Item(0);
$autoShape = $slide->getShapes()->get_Item(0);
$autoShape->getTextFrame()->getTextFrameFormat()->setTextVerticalType(TextVerticalType::Vertical270);
$presentation->save("text_rotation.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
نتیجه:

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

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

کنترل شکست خط
قواعد شکست خط پاراگراف در بلوکهای متن باریک و ارائههای ترکیبی که متن لاتین و آسیای شرقی را مخلوط میکنند، مفید هستند. متدهای زیر متعلق به ParagraphFormat هستند، بنابراین بر کل پاراگراف اعمال میشوند:
- setLatinLineBreak قوانین شکست خط لاتین را کنترل میکند. در متن ترکیبی، تغییر آن میتواند مکان بسته شدن متن و علائم نقطهگذاری آسیای شرقی را نیز تغییر دهد.
- setEastAsianLineBreak قوانین شکست خط آسیای شرقی را کنترل میکند، از جمله محدودیتهای کاراکترها در ابتدای یا پایان خط.
این قواعد جایگزین TextFrameFormat::setWrapText که خودکار بسته شدن متن را درون چارچوب فعال میکند، نیستند. آنها چیدمان را هنگام wrapping تحت تأثیر قرار میدهند؛ کاراکترهای شکست خط را وارد نمیکنند. یک شکست خط صریح یک خط جدید درون پاراگراف ایجاد میکند، صرفنظر از عرض موجود.
مثال خودکفای زیر یک بلوک متن باریک شامل چینی و لاتین ایجاد میکند. هر دو گزینهٔ شکست خط بهصورت صریح تنظیم میشوند و «line_breaking.pptx» ذخیره میشود. برای آزمایش هر قاعده، مقدار مربوطه را تغییر دهید و تنظیمات دیگر را ثابت نگه دارید. مثال از Arial ۲۴ پوینت و SimSun با عرض چارچوب ۱۶۰ پوینت و حاشیهٔ افقی صفر استفاده میکند. TextFrameFormat::setAutofitType با TextAutofitType::None فراخوانی میشود تا اندازهٔ متن و ابعاد چارچوب ثابت بمانند.
use aspose\slides\FillType;
use aspose\slides\FontData;
use aspose\slides\NullableBool;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
use aspose\slides\TextAlignment;
use aspose\slides\TextAutofitType;
$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$shape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 50, 50, 160, 300);
$shape->getFillFormat()->setFillType(FillType::NoFill);
$textFrame = $shape->getTextFrame();
$textFrame->getTextFrameFormat()->setWrapText(NullableBool::True);
$textFrame->getTextFrameFormat()->setAutofitType(TextAutofitType::None);
$textFrame->getTextFrameFormat()->setMarginLeft(0);
$textFrame->getTextFrameFormat()->setMarginRight(0);
$paragraph = $textFrame->getParagraphs()->get_Item(0);
$paragraph->setText("中文排版测试,PowerPoint 中文演示。");
$format = $paragraph->getParagraphFormat();
$format->setAlignment(TextAlignment::Left);
$format->getDefaultPortionFormat()->setFontHeight(24);
$latinFont = new FontData("Arial");
$format->getDefaultPortionFormat()->setLatinFont($latinFont);
$eastAsianFont = new FontData("SimSun");
$format->getDefaultPortionFormat()->setEastAsianFont($eastAsianFont);
$format->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
$blackColor = java("java.awt.Color")->BLACK;
$format->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor($blackColor);
$format->setLatinLineBreak(NullableBool::False);
$format->setEastAsianLineBreak(NullableBool::True);
$presentation->save("line_breaking.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
کنترل نقطهگذاری معلق
ParagraphFormat::setHangingPunctuation اجازه میدهد علائم نقطهگذاری واجد شرایط فراتر از لبهٔ راست خط متن امتداد یابند بهجای اینکه در خط بعدی جای بگیرند. این تنظیم برای تمام پاراگراف اعمال میشود و متفاوت از تورفتگی معلق است.
مثال خودکفای زیر نقطهگذاری معلق را در یک چارچوب متن ۱۰۰ پوینتی فعال میکند و «hanging_punctuation.pptx» را ذخیره میکند. با Arial ۲۴ پوینت و حاشیهٔ افقی صفر، نقطهٔ نهایی پس از «sentence» میماند و از لبهٔ راست متن فراتر میرود. برای مقایسه مقدار را به NullableBool::False تنظیم کنید: با این تنظیمات، نقطه در خط جداگانهای قرار میگیرد. wrapping فعال و autofit غیرفعال است تا عرض موجود ثابت بماند.
use aspose\slides\FillType;
use aspose\slides\FontData;
use aspose\slides\NullableBool;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
use aspose\slides\TextAlignment;
use aspose\slides\TextAutofitType;
$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$shape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 50, 50, 100, 200);
$shape->getFillFormat()->setFillType(FillType::NoFill);
$textFrame = $shape->getTextFrame();
$textFrame->getTextFrameFormat()->setWrapText(NullableBool::True);
$textFrame->getTextFrameFormat()->setAutofitType(TextAutofitType::None);
$textFrame->getTextFrameFormat()->setMarginLeft(0);
$textFrame->getTextFrameFormat()->setMarginRight(0);
$paragraph = $textFrame->getParagraphs()->get_Item(0);
$paragraph->setText("Simple text, next sentence.");
$format = $paragraph->getParagraphFormat();
$format->setAlignment(TextAlignment::Left);
$format->getDefaultPortionFormat()->setFontHeight(24);
$latinFont = new FontData("Arial");
$format->getDefaultPortionFormat()->setLatinFont($latinFont);
$format->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
$blackColor = java("java.awt.Color")->BLACK;
$format->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor($blackColor);
$format->setHangingPunctuation(NullableBool::True);
$presentation->save("hanging_punctuation.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
همهٔ علائم نقطهگذاری قابلیت معلق شدن ندارند. شرایط قلم و چیدمان شرحدادهشده در کنترل شکست خط نیز بر این مقایسه اعمال میشود: تغییر قلم، عرض موجود، حاشیهها یا تنظیمات autofit میتواند تفاوت ظاهری را از بین ببرد.
تنظیم نوع خودسازگاری برای چارچوبهای متن
TextFrameFormat::setAutofitType تعیین میکند متن وقتی از مرزهای کانتینر خود فراتر میرود، چگونه رفتار کند. از آن برای کنترل اینکه متن کوچک شود، سرریز کند یا شکل را بهصورت خودکار برای متن مقیاسبندی کند، استفاده کنید. مثال زیر شکل را برای مقیاسبندی بهمنظور جایگیری متن تنظیم میکند و نتیجه را در «autofit_type.pptx» ذخیره میکند.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\TextAutofitType;
$presentation = new Presentation("sample.pptx");
try {
$slide = $presentation->getSlides()->get_Item(0);
$autoShape = $slide->getShapes()->get_Item(0);
$autoShape->getTextFrame()->getTextFrameFormat()->setAutofitType(TextAutofitType::Shape);
$presentation->save("autofit_type.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
برای شمارش خطوط پس از بسته شدن خودکار و مشاهدهٔ نحوهٔ تغییر عرض متن یا شکل، به شمارش خطوط رندر شده مراجعه کنید. تنها تعداد خطوط نشانگر سرریز شدن متن از کانتینر نیست.
تنظیم لنگر برای چارچوبهای متن
TextFrameFormat::setAnchoringType تعریف میکند متن بهصورت عمودی داخل یک شکل چگونه موقعیتگیری کند، بهعنوان مثال در بالا، وسط یا پایین. مثال زیر متن را به پایینترین شکل اولین شکل لنگر میکند و نتیجه را در «text_anchor.pptx» ذخیره میکند.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\TextAnchorType;
$presentation = new Presentation("sample.pptx");
try {
$slide = $presentation->getSlides()->get_Item(0);
$autoShape = $slide->getShapes()->get_Item(0);
$autoShape->getTextFrame()->getTextFrameFormat()->setAnchoringType(TextAnchorType::Bottom);
$presentation->save("text_anchor.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
تنظیم برگهگذاری متن
از ParagraphFormat::setDefaultTabSize و ParagraphFormat::getTabs برای پیکربندی تبها در یک پاراگراف استفاده کنید. مثال زیر فاصلهٔ پیشفرض تب را به ۱۰۰ پوینت تنظیم میکند و یک تب چپراست در ۳۰ پوینت اضافه میکند. این تنظیمات بر متنی که شامل کاراکترهای تب است تأثیر میگذارد.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\TabAlignment;
$presentation = new Presentation("sample.pptx");
try {
$slide = $presentation->getSlides()->get_Item(0);
$autoShape = $slide->getShapes()->get_Item(0);
$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 BasePortionFormat::setLanguageId را فراهم میکند که به شما امکان میدهد زبان بررسی املایی یک بخش متنی را تنظیم کنید. زبان بررسی املایی تعیین میکند در PowerPoint از کدام زبان برای بررسی املا و گرامر استفاده شود.
مثال زیر به «presentation.pptx» که یک جعبه متن بهعنوان اولین شکل در اسلاید اول دارد و حداقل یک پاراگراف دارد نیاز دارد. محتوای اولین پاراگراف را با «1。」» جایگزین میکند، SimSun را بهعنوان قلم آن تنظیم میکند و زبان بررسی املایی چینی ساده (zh-CN) را اختصاص میدهد. سپس نتیجه را در «proofing_language.pptx» ذخیره میکند:
use aspose\slides\FontData;
use aspose\slides\Portion;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation("presentation.pptx");
try {
$slide = $presentation->getSlides()->get_Item(0);
$autoShape = $slide->getShapes()->get_Item(0);
$paragraph = $autoShape->getTextFrame()->getParagraphs()->get_Item(0);
$paragraph->getPortions()->clear();
$font = new FontData("SimSun");
$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 را برای اولین بخش متنی آن چاپ میکند.
use aspose\slides\LoadOptions;
use aspose\slides\Presentation;
use aspose\slides\ShapeType;
$loadOptions = new LoadOptions();
$loadOptions->setDefaultTextLanguage("en-US");
$presentation = new Presentation($loadOptions);
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);
echo $portion->getPortionFormat()->getLanguageId();
} finally {
$presentation->dispose();
}
تنظیم استایل پیشفرض متن
برای اعمال قالببندی پیشفرض متن در سطح ارائه، از Presentation::getDefaultTextStyle استفاده کنید.
مثال زیر قلم ۱۴ پوینت بولد را بهعنوان پیشفرض برای پاراگرافهای سطح بالا در یک ارائهٔ جدید تنظیم میکند و در «default_text_style.pptx» ذخیره میکند. متن میتواند این پیشفرضها را ارثبری کند مگر اینکه قالببندی خاصتر آنها را بازنویسی کند.
use aspose\slides\NullableBool;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation();
try {
// دریافت قالب پاراگراف سطح بالا.
$paragraphFormat = $presentation->getDefaultTextStyle()->getLevel(0);
if (!java_is_null($paragraphFormat)) {
$paragraphFormat->getDefaultPortionFormat()->setFontHeight(14);
$paragraphFormat->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 استخراج کنید:
use aspose\slides\Presentation;
use aspose\slides\TextCapType;
$presentation = new Presentation("sample2.pptx");
try {
$slide = $presentation->getSlides()->get_Item(0);
$autoShape = $slide->getShapes()->get_Item(0);
$textPortion = $autoShape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0);
$originalText = $textPortion->getText();
echo "Original text: ", $originalText, "\n";
$textFormat = $textPortion->getPortionFormat()->getEffective();
if (java_values($textFormat->getTextCapType()) === TextCapType::All) {
$text = strtoupper($originalText);
echo "All-Caps effect: ", $text, "\n";
}
} finally {
$presentation->dispose();
}
خروجی:
Original text: Hello, Aspose!
All-Caps effect: HELLO, ASPOSE!
سؤالات متداول
چگونه متن در جدول یک اسلاید را ویرایش کنم؟
برای ویرایش متن در جدول یک اسلاید، از Table استفاده کنید. در سلولها پیمایش کنید و هر سلول را با استفاده از Cell::getTextFrame بهروزرسانی کنید و قالببندی پاراگراف را از طریق Paragraph::getParagraphFormat تنظیم کنید.
چگونه رنگ گرادیان را به متن در یک اسلاید پاورپوینت اعمال کنم؟
برای اعمال رنگ گرادیان به متن، از BasePortionFormat::getFillFormat استفاده کنید. FillFormat::setFillType را به FillType::Gradient تنظیم کنید و توقفهای گرادیان، جهت و شفافیت را پیکربندی کنید.