مدیریت پاراگراف‌های متن PowerPoint در C++

معرفی

Aspose.Slides تمام رابط‌ها و کلاس‌هایی را که برای کار با متون، پاراگراف‌ها و بخش‌های PowerPoint در C++ نیاز دارید، ارائه می‌دهد.

  • Aspose.Slides رابط ITextFrame را فراهم می‌کند تا امکان افزودن اشیائی که یک پاراگراف را نمایندگی می‌کنند، فراهم شود. یک شی ITextFame می‌تواند یک یا چند پاراگراف داشته باشد (هر پاراگراف از طریق یک بازگشت کاراکتر ایجاد می‌شود).
  • Aspose.Slides رابط IParagraph را فراهم می‌کند تا امکان افزودن اشیائی که بخش‌ها را نمایندگی می‌کنند، فراهم شود. یک شی IParagraph می‌تواند یک یا چند بخش داشته باشد (مجموعه‌ای از اشیاء iPortions).
  • Aspose.Slides رابط IPortion را فراهم می‌کند تا امکان افزودن اشیائی که متن‌ها و ویژگی‌های قالب‌بندی آن‌ها را نمایندگی می‌کنند، فراهم شود.

یک شی IParagraph می‌تواند متن‌ها را با ویژگی‌های قالب‌بندی مختلف از طریق اشیاء IPortion زیرین خود، مدیریت کند.

افزودن چندین پاراگراف حاوی چندین بخش

این مراحل نشان می‌دهند که چگونه یک فریم متن حاوی ۳ پاراگراف و هر پاراگراف حاوی ۳ بخش اضافه کنید:

  1. یک نمونه از کلاس Presentation ایجاد کنید.
  2. از طریق اندیس، به مرجع اسلاید مربوطه دسترسی پیدا کنید.
  3. یک IAutoShape مستطیل به اسلاید اضافه کنید.
  4. فریم متن ITextFrame مرتبط با IAutoShape را دریافت کنید.
  5. دو شیء IParagraph ایجاد کنید و آن‌ها را به مجموعه IParagraphs از ITextFrame اضافه کنید.
  6. برای هر IParagraph جدید، سه شیء IPortion ایجاد کنید (دو شیء Portion برای پاراگراف پیش‌فرض) و هر شیء IPortion را به مجموعه IPortion هر IParagraph اضافه کنید.
  7. برای هر بخش متنی مقداردهی کنید.
  8. ویژگی‌های قالب‌بندی دلخواه خود را به هر بخش با استفاده از ویژگی‌های قالب‌بندی موجود در شیء IPortion اعمال کنید.
  9. ارائه تغییر یافته را ذخیره کنید.

این کد C++ پیاده‌سازی مراحلی برای افزودن پاراگراف‌های حاوی بخش‌ها است:

// مسیر به پوشه اسناد.
const String outPath = u"../out/MultipleParagraphs_out.pptx";



// بارگذاری ارائه مورد نظر
SharedPtr<Presentation> pres = MakeObject<Presentation>();

// دسترسی به اسلاید اول
SharedPtr<ISlide> sld = pres->get_Slides()->idx_get(0);

// افزودن AutoShape از نوع Rectangle
SharedPtr<IAutoShape>  ashp = sld->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 150, 75, 150, 50);

// افزودن TextFrame به Rectangle
SharedPtr<ITextFrame> tf=ashp->AddTextFrame(u" ");


// دسترسی به پاراگراف اول
SharedPtr<IParagraph> para0 = tf->get_Paragraphs()->idx_get(0);
	
SharedPtr<Portion> port01 = MakeObject<Portion>();
SharedPtr<Portion> port02 = MakeObject<Portion>();
para0->get_Portions()->Add(port01);
para0->get_Portions()->Add(port02);

// افزودن پاراگراف دوم
SharedPtr<Paragraph> para1 = MakeObject<Paragraph>();
tf->get_Paragraphs()->Add(para1);
SharedPtr<Portion> port10 = MakeObject<Portion>();
SharedPtr<Portion> port11 = MakeObject<Portion>();
SharedPtr<Portion> port12 = MakeObject<Portion>();
para1->get_Portions()->Add(port10);
para1->get_Portions()->Add(port11);
para1->get_Portions()->Add(port12);

// افزودن پاراگراف سوم
SharedPtr<Paragraph> para2 = MakeObject<Paragraph>();
tf->get_Paragraphs()->Add(para2);
SharedPtr<Portion> port20 = MakeObject<Portion>();
SharedPtr<Portion> port21 = MakeObject<Portion>();
SharedPtr<Portion> port22 = MakeObject<Portion>();
para2->get_Portions()->Add(port20);
para2->get_Portions()->Add(port21);
para2->get_Portions()->Add(port22);


for (int i = 0; i < 3; i++)
{
	for (int j = 0; j < 3; j++)
	{
		tf->get_Paragraphs()->idx_get(i)->get_Portions()->idx_get(j)->set_Text(u"Portion_"+j);
		SharedPtr<IPortionFormat>format = tf->get_Paragraphs()->idx_get(i)->get_Portions()->idx_get(j)->get_PortionFormat();

		if (j == 0)
		{
			format->get_FillFormat()->set_FillType(FillType::Solid);
			format->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Red());
			format->set_FontBold(NullableBool::True);
			format->set_FontHeight(15);
		}
		else if (j == 1)
		{
			format->get_FillFormat()->set_FillType(FillType::Solid);
			format->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Blue());
			format->set_FontBold(NullableBool::True);
			format->set_FontHeight(18);
		}
	}

}

// ذخیره PPTX روی دیسک
pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);

مدیریت گلوله‌های پاراگراف

فهرست‌های گلوله‌ای به شما کمک می‌کنند تا اطلاعات را به‌سرعت و به‌صورت کارآمد سازماندهی و ارائه دهید. پاراگراف‌های دارای گلوله همیشه خواندن و درک آسان‌تری دارند.

  1. یک نمونه از کلاس Presentation ایجاد کنید.
  2. از طریق اندیس، به مرجع اسلاید مربوطه دسترسی پیدا کنید.
  3. یک autoshape به اسلاید انتخاب شده اضافه کنید.
  4. به TextFrame شکل دسترسی پیدا کنید.
  5. پاراگراف پیش‌فرض در TextFrame را حذف کنید.
  6. اولین نمونه پاراگراف را با استفاده از کلاس Paragraph ایجاد کنید.
  7. ویژگی Type گلوله برای پاراگراف را به Symbol تنظیم کنید و کاراکتر گلوله را تعیین کنید.
  8. متن پاراگراف را تنظیم کنید.
  9. تورفتگی Indent پاراگراف برای گلوله را تنظیم کنید.
  10. رنگی برای گلوله تعیین کنید.
  11. ارتفاع گلوله را تنظیم کنید.
  12. پاراگراف جدید را به مجموعه پاراگراف‌های TextFrame اضافه کنید.
  13. پاراگراف دوم را اضافه کنید و فرآیند را از مرحله 7 تا 13 تکرار کنید.
  14. ارائه را ذخیره کنید.

این کد C++ نشان می‌دهد که چگونه یک گلوله پاراگراف اضافه کنید:

// مسیر به پوشه اسناد.
const String outPath = u"../out/ParagraphBullets_out.pptx";
const String templatePath = u"../templates/DefaultFonts.pptx";
const String ImagePath = u"../templates/Tulips.jpg";

// بارگذاری ارائه مورد نظر
SharedPtr<Presentation> pres = MakeObject<Presentation>();

// دسترسی به اسلاید اول
SharedPtr<ISlide> sld = pres->get_Slides()->idx_get(0);

// افزودن AutoShape از نوع Rectangle
SharedPtr<IAutoShape>  ashp = sld->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 150, 75, 150, 50);

// افزودن TextFrame به Rectangle
ashp->AddTextFrame(u"");

// دسترسی به فریم متن
SharedPtr<ITextFrame>  txtFrame = ashp->get_TextFrame();
txtFrame->get_Paragraphs()->Clear();

// ایجاد شی Paragraph برای فریم متن
SharedPtr<Paragraph> paragraph = MakeObject<Paragraph>();

// تنظیم متن
paragraph->set_Text(u"Welcome to Aspose.Slides");

// تنظیم تورفتگی گلوله
paragraph->get_ParagraphFormat()->set_Indent (25);

// تنظیم رنگ گلوله
paragraph->get_ParagraphFormat()->get_Bullet()->get_Color()->set_ColorType ( ColorType::RGB);
paragraph->get_ParagraphFormat()->get_Bullet()->get_Color()->set_Color(Color::get_Black());
	
// تنظیم IsBulletHardColor به true برای استفاده از رنگ دلخواه گلوله
paragraph->get_ParagraphFormat()->get_Bullet()->set_IsBulletHardColor(NullableBool::True); 
																		
// تنظیم ارتفاع گلوله
paragraph->get_ParagraphFormat()->get_Bullet()->set_Height(100);

// افزودن Paragraph به فریم متن
txtFrame->get_Paragraphs()->Add(paragraph);

// ایجاد پاراگراف دوم
// ایجاد شی Paragraph برای فریم متن
SharedPtr<Paragraph> paragraph2 = MakeObject<Paragraph>();

// تنظیم متن
paragraph2->set_Text(u"This is numbered bullet");

// تنظیم نوع و سبک گلوله پاراگراف
paragraph2->get_ParagraphFormat()->get_Bullet()->set_Type ( BulletType::Numbered);
paragraph2->get_ParagraphFormat()->get_Bullet()->set_NumberedBulletStyle ( NumberedBulletStyle::BulletCircleNumWDBlackPlain);

// تنظیم تورفتگی گلوله
paragraph2->get_ParagraphFormat()->set_Indent(25);

// تنظیم رنگ گلوله
paragraph2->get_ParagraphFormat()->get_Bullet()->get_Color()->set_ColorType(ColorType::RGB);
paragraph2->get_ParagraphFormat()->get_Bullet()->get_Color()->set_Color(Color::get_Black());

// تنظیم IsBulletHardColor به true برای استفاده از رنگ دلخواه گلوله
paragraph2->get_ParagraphFormat()->get_Bullet()->set_IsBulletHardColor(NullableBool::True);

// تنظیم ارتفاع گلوله
paragraph2->get_ParagraphFormat()->get_Bullet()->set_Height(100);

// افزودن Paragraph به فریم متن
txtFrame->get_Paragraphs()->Add(paragraph2);


// ذخیره PPTX روی دیسک
pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);

مدیریت گلوله‌های تصویری

فهرست‌های گلوله‌ای به شما کمک می‌کنند تا اطلاعات را به‌سرعت و به‌صورت کارآمد سازماندهی و ارائه دهید. پاراگراف‌های تصویری خواندن و درک آسان‌تری دارند.

  1. یک نمونه از کلاس Presentation ایجاد کنید.
  2. از طریق اندیس، به مرجع اسلاید مربوطه دسترسی پیدا کنید.
  3. یک autoshape به اسلاید اضافه کنید.
  4. به TextFrame شکل دسترسی پیدا کنید.
  5. پاراگراف پیش‌فرض در TextFrame را حذف کنید.
  6. اولین نمونه پاراگراف را با استفاده از کلاس Paragraph ایجاد کنید.
  7. تصویر را در IPPImage بارگیری کنید.
  8. نوع گلوله را به Picture تنظیم کنید و تصویر را تعیین کنید.
  9. متن پاراگراف را تنظیم کنید.
  10. تورفتگی Indent پاراگراف برای گلوله را تنظیم کنید.
  11. رنگی برای گلوله تعیین کنید.
  12. ارتفاع گلوله را تنظیم کنید.
  13. پاراگراف جدید را به مجموعه پاراگراف‌های TextFrame اضافه کنید.
  14. پاراگراف دوم را اضافه کنید و فرآیند را بر اساس مراحل قبلی تکرار کنید.
  15. ارائه تغییر یافته را ذخیره کنید.

این کد C++ نشان می‌دهد که چگونه گلوله‌های تصویری را اضافه و مدیریت کنید:

// یک شی از کلاس Presentation ایجاد می‌کند که نمایانگر فایل PPTX است
System::SharedPtr<Presentation> presentation = System::MakeObject<Presentation>();

// به اسلاید اول دسترسی می‌یابد
System::SharedPtr<ISlide> slide = presentation->get_Slide(0);

// یک تصویر برای گلوله‌ها ایجاد می‌کند
System::SharedPtr<IImage> image = Images::FromFile(u"bullets.png");
System::SharedPtr<IPPImage> ippxImage = presentation->get_Images()->AddImage(image);

// یک Autoshape اضافه می‌کند و به آن دسترسی می‌یابد
System::SharedPtr<IAutoShape> autoShape = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 200.0f, 200.0f, 400.0f, 200.0f);

// به TextFrame شکل دسترسی می‌یابد
System::SharedPtr<ITextFrame> textFrame = autoShape->get_TextFrame();

// پاراگراف پیش‌فرض را حذف می‌کند
System::SharedPtr<IParagraphCollection> paragraphs = textFrame->get_Paragraphs();
paragraphs->RemoveAt(0);

// یک پاراگراف جدید ایجاد می‌کند
System::SharedPtr<Paragraph> paragraph = System::MakeObject<Paragraph>();
paragraph->set_Text(u"Welcome to Aspose.Slides");

// سبک گلوله پاراگراف و تصویر را تنظیم می‌کند
paragraph->get_ParagraphFormat()->get_Bullet()->set_Type(BulletType::Picture);
paragraph->get_ParagraphFormat()->get_Bullet()->get_Picture()->set_Image(ippxImage);

// ارتفاع گلوله را تنظیم می‌کند
paragraph->get_ParagraphFormat()->get_Bullet()->set_Height(100.0f);

// پاراگراف را به TextFrame اضافه می‌کند
paragraphs->Add(paragraph);

// ارائه را به عنوان فایل PPTX ذخیره می‌کند
presentation->Save(u"ParagraphPictureBulletsPPTX_out.pptx", SaveFormat::Pptx);

// ارائه را به عنوان فایل PPT ذخیره می‌کند
presentation->Save(u"ParagraphPictureBulletsPPT_out.ppt", SaveFormat::Ppt);

مدیریت گلوله‌های چندسطحی

فهرست‌های گلوله‌ای به شما کمک می‌کنند تا اطلاعات را به‌سرعت و به‌صورت کارآمد سازماندهی و ارائه دهید. گلوله‌های چندسطحی خواندن و درک آسان‌تری دارند.

  1. یک نمونه از کلاس Presentation ایجاد کنید.
  2. از طریق اندیس، به مرجع اسلاید مربوطه دسترسی پیدا کنید.
  3. یک autoshape در اسلاید جدید اضافه کنید.
  4. به TextFrame شکل دسترسی پیدا کنید.
  5. پاراگراف پیش‌فرض در TextFrame را حذف کنید.
  6. اولین نمونه پاراگراف را از طریق کلاس Paragraph ایجاد کنید و عمق را به ۰ تنظیم کنید.
  7. دومین نمونه پاراگراف را از طریق کلاس Paragraph ایجاد کنید و عمق را به ۱ تنظیم کنید.
  8. سومین نمونه پاراگراف را از طریق کلاس Paragraph ایجاد کنید و عمق را به ۲ تنظیم کنید.
  9. چهارمین نمونه پاراگراف را از طریق کلاس Paragraph ایجاد کنید و عمق را به ۳ تنظیم کنید.
  10. پاراگراف‌های جدید را به مجموعه پاراگراف‌های TextFrame اضافه کنید.
  11. ارائه تغییر یافته را ذخیره کنید.

این کد C++ نشان می‌دهد که چگونه گلوله‌های چندسطحی را اضافه و مدیریت کنید:

// یک شی از کلاس Presentation ایجاد می‌کند که نمایانگر فایل PPTX است
System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>();

// به اسلاید اول دسترسی می‌یابد
System::SharedPtr<ISlide> slide = pres->get_Slide(0);

// یک Autoshape اضافه می‌کند و به آن دسترسی می‌یابد
System::SharedPtr<IAutoShape> aShp = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 200.0f, 200.0f, 400.0f, 200.0f);

// به فریم متن شکل ایجاد شده دسترسی می‌یابد
System::SharedPtr<ITextFrame> text = aShp->AddTextFrame(u"");

// پاراگراف پیش‌فرض را پاک می‌کند
text->get_Paragraphs()->Clear();

// پاراگراف اول را اضافه می‌کند
System::SharedPtr<IParagraph> para1 = System::MakeObject<Paragraph>();
para1->set_Text(u"Content");
System::SharedPtr<IParagraphFormat> para1Format = para1->get_ParagraphFormat();
System::SharedPtr<IBulletFormat> bullet1Format = para1Format->get_Bullet();
bullet1Format->set_Type(BulletType::Symbol);
bullet1Format->set_Char(System::Convert::ToChar(8226));
System::SharedPtr<IFillFormat> defaultFillFormat1 = para1Format->get_DefaultPortionFormat()->get_FillFormat();
defaultFillFormat1->set_FillType(FillType::Solid);
defaultFillFormat1->get_SolidFillColor()->set_Color(System::Drawing::Color::get_Black());
// تنظیم سطح گلوله
para1Format->set_Depth(0);

// پاراگراف دوم را اضافه می‌کند
System::SharedPtr<IParagraph> para2 = System::MakeObject<Paragraph>();
para2->set_Text(u"Second Level");
System::SharedPtr<IParagraphFormat> para2Format = para2->get_ParagraphFormat();
System::SharedPtr<IBulletFormat> bullet2Format = para2Format->get_Bullet();
bullet2Format->set_Type(BulletType::Symbol);
bullet2Format->set_Char(u'-');
System::SharedPtr<IFillFormat> defaultFillFormat2 = para2Format->get_DefaultPortionFormat()->get_FillFormat();
defaultFillFormat2->set_FillType(FillType::Solid);
defaultFillFormat2->get_SolidFillColor()->set_Color(System::Drawing::Color::get_Black());
// تنظیم سطح گلوله
para2Format->set_Depth(1);

// پاراگراف سوم را اضافه می‌کند
System::SharedPtr<IParagraph> para3 = System::MakeObject<Paragraph>();
para3->set_Text(u"Third Level");
System::SharedPtr<IParagraphFormat> para3Format = para3->get_ParagraphFormat();
System::SharedPtr<IBulletFormat> bullet3Format = para3Format->get_Bullet();
bullet3Format->set_Type(BulletType::Symbol);
bullet3Format->set_Char(System::Convert::ToChar(8226));
System::SharedPtr<IFillFormat> defaultFillFormat3 = para3Format->get_DefaultPortionFormat()->get_FillFormat();
defaultFillFormat3->set_FillType(FillType::Solid);
defaultFillFormat3->get_SolidFillColor()->set_Color(System::Drawing::Color::get_Black());
// تنظیم سطح گلوله
para3Format->set_Depth(2);

// پاراگراف چهارم را اضافه می‌کند
System::SharedPtr<IParagraph> para4 = System::MakeObject<Paragraph>();
para4->set_Text(u"Fourth Level");
System::SharedPtr<IParagraphFormat> para4Format = para4->get_ParagraphFormat();
System::SharedPtr<IBulletFormat> bullet4Format = para4Format->get_Bullet();
bullet4Format->set_Type(BulletType::Symbol);
bullet4Format->set_Char(u'-');
System::SharedPtr<IFillFormat> defaultFillFormat4 = para4Format->get_DefaultPortionFormat()->get_FillFormat();
defaultFillFormat4->set_FillType(FillType::Solid);
defaultFillFormat4->get_SolidFillColor()->set_Color(System::Drawing::Color::get_Black());
// تنظیم سطح گلوله
para4Format->set_Depth(3);

// پاراگراف‌ها را به مجموعه اضافه می‌کند
System::SharedPtr<IParagraphCollection> paragraphs = text->get_Paragraphs();
paragraphs->Add(para1);
paragraphs->Add(para2);
paragraphs->Add(para3);
paragraphs->Add(para4);

// ارائه را به صورت فایل PPTX ذخیره می‌کند
pres->Save(u"MultilevelBullet.pptx", SaveFormat::Pptx);

مدیریت پاراگراف با فهرست شماره‌گذاری سفارشی

رابط IBulletFormat ویژگی NumberedBulletStartWith و سایر ویژگی‌ها را فراهم می‌کند که به شما امکان مدیریت پاراگراف‌ها با شماره‌گذاری یا قالب‌بندی سفارشی را می‌دهد.

  1. یک نمونه از کلاس Presentation ایجاد کنید.
  2. به اسلایدی که حاوی پاراگراف است دسترسی پیدا کنید.
  3. یک autoshape به اسلاید اضافه کنید.
  4. به TextFrame شکل دسترسی پیدا کنید.
  5. پاراگراف پیش‌فرض در TextFrame را حذف کنید.
  6. اولین نمونه پاراگراف را از طریق کلاس Paragraph ایجاد کنید و NumberedBulletStartWith را بر روی ۲ تنظیم کنید.
  7. دومین نمونه پاراگراف را از طریق کلاس Paragraph ایجاد کنید و NumberedBulletStartWith را بر روی ۳ تنظیم کنید.
  8. سومین نمونه پاراگراف را از طریق کلاس Paragraph ایجاد کنید و NumberedBulletStartWith را بر روی ۷ تنظیم کنید.
  9. پاراگراف‌های جدید را به مجموعه پاراگراف‌های TextFrame اضافه کنید.
  10. ارائه تغییر یافته را ذخیره کنید.

این کد C++ نشان می‌دهد که چگونه پاراگراف‌ها را با شماره‌گذاری یا قالب‌بندی سفارشی اضافه و مدیریت کنید:

auto presentation = System::MakeObject<Presentation>();

auto shape = presentation->get_Slide(0)->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 200.0f, 200.0f, 400.0f, 200.0f);

// به فریم متن شکل ایجاد شده دسترسی می‌یابد
System::SharedPtr<ITextFrame> textFrame = shape->get_TextFrame();

// پاراگراف پیش‌فرض موجود را حذف می‌کند
textFrame->get_Paragraphs()->RemoveAt(0);

// فهرست اول
auto paragraph1 = System::MakeObject<Paragraph>();
paragraph1->set_Text(u"bullet 2");
auto paragraph1Format = paragraph1->get_ParagraphFormat();
paragraph1Format->set_Depth(4);
auto bullet1Format = paragraph1Format->get_Bullet();
bullet1Format->set_NumberedBulletStartWith(2);
bullet1Format->set_Type(BulletType::Numbered);
textFrame->get_Paragraphs()->Add(paragraph1);

auto paragraph2 = System::MakeObject<Paragraph>();
paragraph2->set_Text(u"bullet 3");
auto paragraph2Format = paragraph2->get_ParagraphFormat();
paragraph2Format->set_Depth(4);
auto bullet2Format = paragraph2Format->get_Bullet();
bullet2Format->set_NumberedBulletStartWith(3);
bullet2Format->set_Type(BulletType::Numbered);
textFrame->get_Paragraphs()->Add(paragraph2);

auto paragraph5 = System::MakeObject<Paragraph>();
paragraph5->set_Text(u"bullet 7");
auto paragraph5Format = paragraph5->get_ParagraphFormat();
paragraph5Format->set_Depth(4);
auto bullet5Format = paragraph5Format->get_Bullet();
bullet5Format->set_NumberedBulletStartWith(7);
bullet5Format->set_Type(BulletType::Numbered);
textFrame->get_Paragraphs()->Add(paragraph5);

presentation->Save(u"SetCustomBulletsNumber-slides.pptx", SaveFormat::Pptx);

تنظیم تورفتگی خط اول برای یک پاراگراف

از متد IParagraphFormat::set_Indent برای کنترل تورفتگی خط اول یک پاراگراف استفاده کنید. این متد فقط خط اول را نسبت به حاشیه چپ پاراگراف جابه‌جا می‌کند. مقدار مثبت خط اول را به راست می‌برد، در حالی که خطوط باقی‌مانده به بدنه پاراگراف هم‌راستا می‌مانند.

هنگامی که نیاز به جابجایی کل پاراگراف دارید، از IParagraphFormat::set_MarginLeft استفاده کنید. برای جابجایی فقط خط اول از IParagraphFormat::set_Indent استفاده کنید.

مثال زیر چندین پاراگراف ایجاد می‌کند و مقادیر مختلف Indent را برای نشان دادن تأثیر تورفتگی خط اول بر چینش پاراگراف اعمال می‌نماید.

  1. یک نمونه از کلاس Presentation ایجاد کنید.
  2. به اسلاید هدف دسترسی پیدا کنید.
  3. یک AutoShape مستطیل به اسلاید اضافه کنید.
  4. یک TextFrame خالی به شکل اضافه کنید و پاراگراف پیش‌فرض را حذف کنید.
  5. چندین پاراگراف ایجاد کنید و مقادیر مختلف Indent را برای آن‌ها تنظیم کنید.
  6. پاراگراف‌ها را به فریم متن اضافه کنید.
  7. ارائه تغییر یافته را ذخیره کنید.

این کد نشان می‌دهد که چگونه تورفتگی پاراگراف را تنظیم کنید:

auto presentation = MakeObject<Presentation>();
auto slide = presentation->get_Slide(0);

auto rectangleShape = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 50, 50, 420, 220);
rectangleShape->get_FillFormat()->set_FillType(FillType::NoFill);
rectangleShape->get_LineFormat()->get_FillFormat()->set_FillType(FillType::Solid);
rectangleShape->get_LineFormat()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Gray());

auto textFrame = rectangleShape->AddTextFrame(u"");
textFrame->get_TextFrameFormat()->set_AutofitType(TextAutofitType::Shape);
textFrame->get_Paragraphs()->RemoveAt(0);

auto firstParagraph = MakeObject<Paragraph>();
firstParagraph->get_ParagraphFormat()->get_DefaultPortionFormat()->get_FillFormat()->set_FillType(FillType::Solid);
firstParagraph->get_ParagraphFormat()->get_DefaultPortionFormat()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Black());
firstParagraph->set_Text(u"No first-line indent. Wrapped lines start at the same position as the first line.");
firstParagraph->get_ParagraphFormat()->set_MarginLeft(20.f);
firstParagraph->get_ParagraphFormat()->set_Indent(0.f);

auto secondParagraph = MakeObject<Paragraph>();
secondParagraph->get_ParagraphFormat()->get_DefaultPortionFormat()->get_FillFormat()->set_FillType(FillType::Solid);
secondParagraph->get_ParagraphFormat()->get_DefaultPortionFormat()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Black());
secondParagraph->set_Text(u"First-line indent of 20 points. The first line moves to the right, while wrapped lines remain aligned to the paragraph body.");
secondParagraph->get_ParagraphFormat()->set_MarginLeft(20.f);
secondParagraph->get_ParagraphFormat()->set_Indent(20.f);

auto thirdParagraph = MakeObject<Paragraph>();
thirdParagraph->get_ParagraphFormat()->get_DefaultPortionFormat()->get_FillFormat()->set_FillType(FillType::Solid);
thirdParagraph->get_ParagraphFormat()->get_DefaultPortionFormat()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Black());
thirdParagraph->set_Text(u"First-line indent of 40 points. This paragraph shows a larger first-line offset to make the effect easier to see.");
thirdParagraph->get_ParagraphFormat()->set_MarginLeft(20.f);
thirdParagraph->get_ParagraphFormat()->set_Indent(40.f);

textFrame->get_Paragraphs()->Add(firstParagraph);
textFrame->get_Paragraphs()->Add(secondParagraph);
textFrame->get_Paragraphs()->Add(thirdParagraph);

presentation->Save(u"paragraph_indent.pptx", SaveFormat::Pptx);
presentation->Dispose();

تورفتگی خط اول پاراگراف‌ها

تنظیم تورفتگی معلق برای یک پاراگراف

تورفتگی معلق یک چیدمان پاراگراف است که در آن خط اول نسبت به خطوط باقی‌مانده به سمت چپ شروع می‌شود. در Aspose.Slides، این اثر را با متد IParagraphFormat::set_Indent ایجاد می‌کنید. مقدار منفی این ویژگی خط اول را نسبت به بدنه پاراگراف به سمت چپ جابه‌جا می‌کند.

در عمل، IParagraphFormat::set_MarginLeft موقعیت چپ بدنه پاراگراف را تعریف می‌کند و IParagraphFormat::set_Indent موقعیت خط اول را نسبت به آن حاشیه تعیین می‌کند. برای ایجاد تورفتگی معلق، مقدار مثبت MarginLeft و مقدار منفی Indent را تنظیم کنید.

این قالب‌بندی برای کتابشناسی‌ها، مراجع، ورودی‌های واژه‌نامه و سایر پاراگراف‌هایی که خطوط بسته‌بندی شده باید زیر بدنه پاراگراف و نه زیر اولین کاراکتر خط اول قرار گیرند، مفید است.

  1. یک نمونه از کلاس Presentation ایجاد کنید.
  2. به اسلاید هدف دسترسی پیدا کنید.
  3. یک AutoShape مستطیل به اسلاید اضافه کنید.
  4. یک TextFrame خالی به شکل اضافه کنید و پاراگراف پیش‌فرض را حذف کنید.
  5. پاراگراف‌ها را ایجاد کنید و برای هر پاراگراف مقدار مثبت MarginLeft تنظیم کنید.
  6. مقدار منفی Indent را برای ایجاد اثر تورفتگی معلق تنظیم کنید.
  7. پاراگراف‌ها را به فریم متن اضافه کنید.
  8. ارائه تغییر یافته را ذخیره کنید.

این کد نشان می‌دهد که چگونه تورفتگی معلق برای یک پاراگراف تنظیم شود:

auto presentation = MakeObject<Presentation>();
auto slide = presentation->get_Slide(0);

auto rectangleShape = slide->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 50, 50, 420, 220);
rectangleShape->get_FillFormat()->set_FillType(FillType::NoFill);
rectangleShape->get_LineFormat()->get_FillFormat()->set_FillType(FillType::Solid);
rectangleShape->get_LineFormat()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Gray());

auto textFrame = rectangleShape->AddTextFrame(u"");
textFrame->get_TextFrameFormat()->set_AutofitType(TextAutofitType::Shape);
textFrame->get_Paragraphs()->RemoveAt(0);

auto firstParagraph = MakeObject<Paragraph>();
firstParagraph->get_ParagraphFormat()->get_DefaultPortionFormat()->get_FillFormat()->set_FillType(FillType::Solid);
firstParagraph->get_ParagraphFormat()->get_DefaultPortionFormat()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Black());
firstParagraph->set_Text(u"A hanging indent is created by combining a positive left margin with a negative indent. The first line starts to the left, while wrapped lines align with the paragraph body.");
firstParagraph->get_ParagraphFormat()->set_MarginLeft(40.f);
firstParagraph->get_ParagraphFormat()->set_Indent(-20.f);

auto secondParagraph = MakeObject<Paragraph>();
secondParagraph->get_ParagraphFormat()->get_DefaultPortionFormat()->get_FillFormat()->set_FillType(FillType::Solid);
secondParagraph->get_ParagraphFormat()->get_DefaultPortionFormat()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Black());
secondParagraph->set_Text(u"This second example uses a deeper hanging indent so the difference between the first line and the wrapped lines is easier to compare.");
secondParagraph->get_ParagraphFormat()->set_MarginLeft(60.f);
secondParagraph->get_ParagraphFormat()->set_Indent(-30.f);

textFrame->get_Paragraphs()->Add(firstParagraph);
textFrame->get_Paragraphs()->Add(secondParagraph);

presentation->Save(u"hhang indent.pptx", SaveFormat::Pptx);
presentation->Dispose();

تورفتگی معلق پاراگراف‌ها

مدیریت ویژگی‌های انتهای پاراگراف

  1. یک نمونه از کلاس Presentation ایجاد کنید.
  2. مرجع اسلاید حاوی پاراگراف را از طریق موقعیت آن دریافت کنید.
  3. یک autoshape مستطیل به اسلاید اضافه کنید.
  4. یک TextFrame با دو پاراگراف به مستطیل اضافه کنید.
  5. FontHeight و نوع فونت را برای پاراگراف‌ها تنظیم کنید.
  6. ویژگی‌های End را برای پاراگراف‌ها تنظیم کنید.
  7. ارائه تغییر یافته را به‌صورت فایل PPTX ذخیره کنید.

این کد C++ نشان می‌دهد که چگونه ویژگی‌های End را برای پاراگراف‌ها در PowerPoint تنظیم کنید:

// مسیر به پوشه اسناد.
const String outPath = u"../out/EndParaGraphProperties_out.pptx";
//const String templatePath = u"../templates/DefaultFonts.pptx";


// بارگذاری ارائه مورد نظر
SharedPtr<Presentation> pres = MakeObject<Presentation>();

// دسترسی به اسلاید اول
SharedPtr<ISlide> sld = pres->get_Slides()->idx_get(0);

// افزودن AutoShape از نوع Rectangle
SharedPtr<IAutoShape>  ashp = sld->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 100, 100, 300, 300);

// افزودن TextFrame به Rectangle
SharedPtr<ITextFrame> tf = ashp->AddTextFrame(String::Empty);

// افزودن پاراگراف اول
//SharedPtr<IParagraph> para1 = tf->get_Paragraphs()->idx_get(0);

SharedPtr<Paragraph> para1 = MakeObject<Paragraph>();
SharedPtr<Portion> port01 = MakeObject<Portion>(u"Sample text");

para1->get_Portions()->Add(port01);

// افزودن پاراگراف دوم
SharedPtr<Paragraph> para2 = MakeObject<Paragraph>();
SharedPtr<Portion> port02 = MakeObject<Portion>(u"Sample text 2");

para2->get_Portions()->Add(port02);


SharedPtr<PortionFormat> endParagraphPortionFormat = MakeObject< PortionFormat>();
endParagraphPortionFormat->set_FontHeight ( 48);
endParagraphPortionFormat->set_LatinFont ( MakeObject< FontData>(u"Times New Roman"));
para2->set_EndParagraphPortionFormat(endParagraphPortionFormat);

ashp->get_TextFrame()->get_Paragraphs()->Add(para1);
ashp->get_TextFrame()->get_Paragraphs()->Add(para2);


// ذخیره PPTX روی دیسک
pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);

وارد کردن متن HTML به پاراگراف‌ها

Aspose.Slides پشتیبانی پیشرفته‌ای برای وارد کردن متن HTML به پاراگراف‌ها فراهم می‌کند.

  1. یک نمونه از کلاس Presentation ایجاد کنید.
  2. از طریق اندیس، به مرجع اسلاید مربوطه دسترسی پیدا کنید.
  3. یک autoshape به اسلاید اضافه کنید.
  4. autoshape را اضافه کنید و به ITextFrame دسترسی پیدا کنید.
  5. پاراگراف پیش‌فرض در ITextFrame را حذف کنید.
  6. فایل HTML منبع را در یک TextReader بخوانید.
  7. اولین نمونه پاراگراف را از طریق کلاس Paragraph ایجاد کنید.
  8. محتوای فایل HTML را از TextReader خوانده شده به ParagraphCollection فریم متن اضافه کنید.
  9. ارائه تغییر یافته را ذخیره کنید.

این کد C++ پیاده‌سازی مراحلی برای وارد کردن متون HTML به پاراگراف‌ها است:

For complete examples and data files, please go to https://github.com/aspose-slides/Aspose.Slides-for-C
// مسیر به پوشه اسناد.
const String outPath = u"../out/ImportingHTMLText_out.pptx";
const String sampleHtml = u"../templates/file.html";

	
// بارگذاری ارائه مورد نظر
SharedPtr<Presentation> pres = MakeObject<Presentation>();

// دسترسی به اسلاید اول
SharedPtr<ISlide> sld = pres->get_Slides()->idx_get(0);

// افزودن AutoShape از نوع Rectangle
SharedPtr<IAutoShape>  ashp = sld->get_Shapes()->AddAutoShape(ShapeType::Rectangle, 10, 10, 700, 500);
	
//Resetting default fill color
ashp->get_FillFormat()->set_FillType(FillType::NoFill);
	
// افزودن TextFrame به Rectangle
ashp->AddTextFrame(u" ");

// دسترسی به فریم متن
SharedPtr<ITextFrame>  txtFrame = ashp->get_TextFrame();

//GetParagraphs collection
SharedPtr<Aspose::Slides::IParagraphCollection>ParaCollection = txtFrame->get_Paragraphs();

// Clearing all paragraphs in added text frame
ParaCollection->Clear();

// بارگذاری فایل HTML با استفاده از StreamReader
SharedPtr<System::IO::StreamReader>  tr = MakeObject<System::IO::StreamReader>(sampleHtml);

// افزودن متن از StreamReader HTML به فریم متن
ParaCollection->AddFromHtml(tr->ReadToEnd());


// ایجاد شی Paragraph برای فریم متن
SharedPtr<IParagraph> paragraph = txtFrame->get_Paragraphs()->idx_get(0);

// ایجاد شی Portion برای پاراگراف
SharedPtr<IPortion> portion = paragraph->get_Portions()->idx_get(0);
portion->set_Text(u"Aspose TextBox");

//Get portion format
SharedPtr<IPortionFormat> pf = portion->get_PortionFormat();

// تنظیم فونت برای Portion
pf->set_LatinFont(MakeObject<FontData>(u"Times New Roman"));

// تنظیم ویژگی Bold برای فونت
pf->set_FontBold(NullableBool::True);

// تنظیم ویژگی Italic برای فونت
pf->set_FontItalic(NullableBool::True);

// تنظیم ویژگی Underline برای فونت
pf->set_FontUnderline(TextUnderlineType::Single);

// تنظیم ارتفاع فونت
pf->set_FontHeight(25);

// تنظیم رنگ فونت
pf->get_FillFormat()->set_FillType(FillType::Solid);
pf->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Blue());

// ذخیره PPTX روی دیسک
pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);

صادرات متن پاراگراف به HTML

Aspose.Slides پشتیبانی پیشرفته‌ای برای صادرف متن‌ها (موجود در پاراگراف‌ها) به HTML فراهم می‌کند.

  1. یک نمونه از کلاس Presentation ایجاد کنید و ارائه مورد نظر را بارگذاری کنید.
  2. از طریق اندیس، به مرجع اسلاید مربوطه دسترسی پیدا کنید.
  3. به شکلی که متن مورد نظر برای صادرات به HTML در آن باشد دسترسی پیدا کنید.
  4. به TextFrame شکل دسترسی پیدا کنید.
  5. یک نمونه از StreamWriter ایجاد کنید و فایل HTML جدید را اضافه کنید.
  6. یک اندیس شروع به StreamWriter بدهید و پاراگراف‌های دلخواه خود را صادر کنید.

این کد C++ نشان می‌دهد که چگونه متون پاراگراف‌های PowerPoint را به HTML صادر کنید:

For complete examples and data files, please go to https://github.com/aspose-slides/Aspose.Slides-for-C
// مسیر به پوشه اسناد.
const String outPath = u"../out/output.html";
const String tempplatePath = u"../templates/DefaultFonts.pptx";

// بارگذاری ارائه مورد نظر
SharedPtr<Presentation> pres = MakeObject<Presentation>(tempplatePath);


// دسترسی به اسلاید اول پیش‌فرض ارائه
SharedPtr<ISlide> slide = pres->get_Slides()->idx_get(0);

// اندیس مورد نظر
int index = 0;

// دسترسی به شکل اضافه شده
SharedPtr<IShape> shape = slide->get_Shapes()->idx_get(0);

SharedPtr<AutoShape> ashape = DynamicCast<Aspose::Slides::AutoShape>(shape);

// استخراج اولین پاراگراف به‌صورت HTML
SharedPtr<System::IO::StreamWriter> sw = MakeObject<System::IO::StreamWriter>(outPath, false, Encoding::get_UTF8());
//	System::IO::StreamWriter^ sr = gcnew System::IO::StreamWriter("TestFile.txt", false, Encoding::get_UTF8());

// نوشتن داده‌های پاراگراف‌ها به HTML با ارائه اندیس شروع پاراگراف و تعداد کل پاراگراف‌های قابل کپی
sw->Write(ashape->get_TextFrame()->get_Paragraphs()->ExportToHtml(0, ashape->get_TextFrame()->get_Paragraphs()->get_Count(), nullptr));

sw->Close();

ذخیره یک پاراگراف به‌صورت تصویر

در این بخش، دو مثال را بررسی می‌کنیم که نشان می‌دهند چگونه یک پاراگراف متنی، نماینده توسط رابط IParagraph را به‌صورت تصویر ذخیره کنیم. هر دو مثال شامل دریافت تصویر شکل حاوی پاراگراف با استفاده از متدهای GetImage از رابط IShape، محاسبه مرزهای پاراگراف داخل شکل و صادرات آن به‌صورت تصویر bitmap هستند. این روش‌ها به شما امکان استخراج بخش‌های خاصی از متن از ارائه‌های PowerPoint و ذخیره آن‌ها به‌عنوان تصاویر جداگانه را می‌دهند که می‌تواند در سناریوهای مختلف مفید باشد.

فرض کنید فایلی به نام sample.pptx داریم که شامل یک اسلاید است و اولین شکل آن یک جعبه متن حاوی سه پاراگراف است.

جعبه متن با سه پاراگراف

مثال 1

در این مثال، پاراگراف دوم را به‌صورت تصویر دریافت می‌کنیم. برای این کار، تصویر شکل را از اسلاید اول ارائه استخراج می‌کنیم و سپس مرزهای پاراگراف دوم را در فریم متن شکل محاسبه می‌کنیم. سپس پاراگراف بر روی تصویر bitmap جدید رسم می‌شود که به فرمت PNG ذخیره می‌شود. این روش به‌ویژه زمانی مفید است که نیاز به ذخیره یک پاراگراف خاص به‌صورت تصویر جداگانه داشته باشید در حالی که ابعاد و قالب‌بندی دقیق متن حفظ می‌شود.

auto presentation = MakeObject<Presentation>(u"sample.pptx");
auto firstShape = ExplicitCast<IAutoShape>(presentation->get_Slide(0)->get_Shape(0));

// Save the shape in memory as a bitmap.
auto shapeImage = firstShape->GetImage();
auto shapeImageStream = MakeObject<MemoryStream>();
shapeImage->Save(shapeImageStream, ImageFormat::Png);
shapeImage->Dispose();

// Create a shape bitmap from memory.
shapeImageStream->set_Position(0);
auto shapeBitmap = MakeObject<Bitmap>(Image::FromStream(shapeImageStream));

// Calculate the boundaries of the second paragraph.
auto secondParagraph = firstShape->get_TextFrame()->get_Paragraph(1);
auto paragraphRectangle = secondParagraph->GetRect();

// Calculate the size for the output image (minimum size - 1x1 pixel).
auto imageWidth = std::max(1, (int)Math::Ceiling(paragraphRectangle.get_Width()));
auto imageHeight = std::max(1, (int)Math::Ceiling(paragraphRectangle.get_Height()));

// Prepare a bitmap for the paragraph.
auto paragraphBitmap = MakeObject<Bitmap>(imageWidth, imageHeight);

// Redraw the paragraph from the shape bitmap to the paragraph bitmap.
auto imageGraphics = Graphics::FromImage(paragraphBitmap.get());
RectangleF drawingRectangle(0, 0, paragraphRectangle.get_Width(), paragraphRectangle.get_Height());
imageGraphics->DrawImage(shapeBitmap.get(), drawingRectangle, paragraphRectangle, GraphicsUnit::Pixel);
imageGraphics->Dispose();

paragraphBitmap->Save(u"paragraph.png", Imaging::ImageFormat::get_Png());

presentation->Dispose();

نتیجه:

تصویر پاراگراف

مثال 2

در این مثال، رویکرد قبلی را با افزودن مقیاس‌ها به تصویر پاراگراف گسترش می‌دهیم. شکل از ارائه استخراج می‌شود و با یک مقیاس ۲ به‌صورت تصویر ذخیره می‌شود. این امکان خروجی با وضوح بالاتر را هنگام صادرات پاراگراف فراهم می‌کند. سپس مرزهای پاراگراف با در نظر گرفتن مقیاس محاسبه می‌شود. مقیاس‌بندی می‌تواند وقتی تصویر دقیق‌تری لازم باشد، مفید باشد، به‌عنوان مثال برای استفاده در مواد چاپی با کیفیت بالا.

auto imageScaleX = 2.0f;
auto imageScaleY = imageScaleX;

auto presentation = MakeObject<Presentation>(u"sample.pptx");
auto firstShape = ExplicitCast<IAutoShape>(presentation->get_Slide(0)->get_Shape(0));

// Save the shape in memory as a bitmap with scaling.
auto shapeImage = firstShape->GetImage(ShapeThumbnailBounds::Shape, imageScaleX, imageScaleY);
auto shapeImageStream = MakeObject<MemoryStream>();
shapeImage->Save(shapeImageStream, ImageFormat::Png);
shapeImage->Dispose();

// Create a shape bitmap from memory.
shapeImageStream->set_Position(0);
auto shapeBitmap = MakeObject<Bitmap>(Image::FromStream(shapeImageStream));

// Calculate the boundaries of the second paragraph.
auto secondParagraph = firstShape->get_TextFrame()->get_Paragraph(1);
auto paragraphRectangle = secondParagraph->GetRect();
paragraphRectangle.set_X(paragraphRectangle.get_X() * imageScaleX);
paragraphRectangle.set_Y(paragraphRectangle.get_Y() * imageScaleY);
paragraphRectangle.set_Width(paragraphRectangle.get_Width() * imageScaleX);
paragraphRectangle.set_Height(paragraphRectangle.get_Height() * imageScaleY);

// Calculate the size for the output image (minimum size - 1x1 pixel).
auto imageWidth = std::max(1, (int)Math::Ceiling(paragraphRectangle.get_Width()));
auto imageHeight = std::max(1, (int)Math::Ceiling(paragraphRectangle.get_Height()));

// Prepare a bitmap for the paragraph.
auto paragraphBitmap = MakeObject<Bitmap>(imageWidth, imageHeight);

// Redraw the paragraph from the shape bitmap to the paragraph bitmap.
auto imageGraphics = Graphics::FromImage(paragraphBitmap.get());
RectangleF drawingRectangle(0, 0, paragraphRectangle.get_Width(), paragraphRectangle.get_Height());
imageGraphics->DrawImage(shapeBitmap.get(), drawingRectangle, paragraphRectangle, GraphicsUnit::Pixel);
imageGraphics->Dispose();

paragraphBitmap->Save(u"paragraph.png", Imaging::ImageFormat::get_Png());

presentation->Dispose();

پرسش‌پاسخ

آیا می‌توانم به‌طور کامل بسته‌بندی خط داخل فریم متن را غیرفعال کنم؟

بله. از متد بسته‌بندی فریم متن (set_WrapText) استفاده کنید تا بسته‌بندی غیرفعال شود و خطوط در لبه‌های فریم شکسته نشوند.

چگونه می‌توانم مرزهای دقیق یک پاراگراف خاص را روی اسلاید به‌دست آورم؟

می‌توانید مستطیل محدب پاراگراف (و حتی یک بخش منفرد) را بازیابی کنید تا موقعیت و اندازه دقیق آن را روی اسلاید بدانید.

کنترل ترازبندی پاراگراف (چپ/راست/وسط/توزیع) در کجا انجام می‌شود؟

ترازبندی (Alignment) یک تنظیم سطح پاراگراف در ParagraphFormat است؛ به‌طور کلی به کل پاراگراف اعمال می‌شود صرف‌نظر از قالب‌بندی هر بخش منفرد.

آیا می‌توانم زبان بررسی املا را فقط برای بخشی از یک پاراگراف (مثلاً یک کلمه) تنظیم کنم؟

بله. زبان در سطح بخش تنظیم می‌شود با استفاده از (PortionFormat::set_LanguageId)، بنابراین می‌توان چندین زبان را در یک پاراگراف داشته باشید.

بهبود ارائه‌های شما با AutoFit در C++ دریافت محدوده پاراگراف‌ها از ارائه‌ها در C++