إدارة فقرات نص PowerPoint في JavaScript

توفر Aspose.Slides جميع الفئات والصفوف التي تحتاجها للعمل مع نصوص PowerPoint والفقرات والجزء في Java.

• Aspose.Slides توفر الفئة TextFrame لتتيح لك إضافة كائنات تمثل فقرة. يمكن لكائن TextFame أن يحتوي على فقرة واحدة أو متعددة (كل فقرة تُنشأ من خلال إرجاع السطر).
• Aspose.Slides توفر الفئة Paragraph لتتيح لك إضافة كائنات تمثل أجزاء. يمكن لكائن Paragraph أن يحتوي على جزء واحد أو متعددة (مجموعة من كائنات أجزاء النص).
• Aspose.Slides توفر الفئة Portion لتتيح لك إضافة كائنات تمثل النصوص وخصائص تنسيقها.

يمكن لكائن Paragraph التعامل مع النصوص ذات الخصائص التنسيقية المختلفة عبر كائنات Portion الموجودة تحته.

إضافة فقرات متعددة تحتوي على أجزاء متعددة

توضح هذه الخطوات كيفية إضافة إطار نص يحتوي على 3 فقرات، وكل فقرة تحتوي على 3 أجزاء:

1. إنشاء مثال من الفئة Presentation.
2. الوصول إلى مرجع الشريحة ذات الصلة عبر رقم الفهرس الخاص بها.
3. إضافة AutoShape على شكل مستطيل إلى الشريحة.
4. الحصول على ITextFrame المرتبط بـ AutoShape.
5. إنشاء كائنين من النوع Paragraph وإضافتهما إلى مجموعة IParagraphs في TextFrame.
6. إنشاء ثلاثة كائنات Portion لكل Paragraph جديد (اثنان من كائنات Portion للفقرة الافتراضية) وإضافة كل كائن Portion إلى مجموعة IPortion الخاصة بكل Paragraph.
7. تعيين نص لكل جزء.
8. تطبيق ميزات التنسيق المفضلة لكل جزء باستخدام خصائص التنسيق التي يتيحها كائن Portion.
9. حفظ العرض التقديمي المعدل.

// إنشاء كائن من فئة Presentation يمثل ملف PPTX
var pres = new aspose.slides.Presentation();
try {
    // الوصول إلى الشريحة الأولى
    var slide = pres.getSlides().get_Item(0);
    // إضافة AutoShape من نوع Rectangle
    var ashp = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 150, 300, 150);
    // الوصول إلى TextFrame للـ AutoShape
    var tf = ashp.getTextFrame();
    // إنشاء فقرات وأجزاء بتنسيقات نص مختلفة
    var para0 = tf.getParagraphs().get_Item(0);
    var port01 = new aspose.slides.Portion();
    var port02 = new aspose.slides.Portion();
    para0.getPortions().add(port01);
    para0.getPortions().add(port02);
    var para1 = new aspose.slides.Paragraph();
    tf.getParagraphs().add(para1);
    var port10 = new aspose.slides.Portion();
    var port11 = new aspose.slides.Portion();
    var port12 = new aspose.slides.Portion();
    para1.getPortions().add(port10);
    para1.getPortions().add(port11);
    para1.getPortions().add(port12);
    var para2 = new aspose.slides.Paragraph();
    tf.getParagraphs().add(para2);
    var port20 = new aspose.slides.Portion();
    var port21 = new aspose.slides.Portion();
    var port22 = new aspose.slides.Portion();
    para2.getPortions().add(port20);
    para2.getPortions().add(port21);
    para2.getPortions().add(port22);
    for (var i = 0; i < 3; i++) {
        for (var j = 0; j < 3; j++) {
            var portion = tf.getParagraphs().get_Item(i).getPortions().get_Item(j);
            portion.setText("Portion0" + j);
            if (j == 0) {
                portion.getPortionFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
                portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "RED"));
                portion.getPortionFormat().setFontBold(aspose.slides.NullableBool.True);
                portion.getPortionFormat().setFontHeight(15);
            } else if (j == 1) {
                portion.getPortionFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
                portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLUE"));
                portion.getPortionFormat().setFontItalic(aspose.slides.NullableBool.True);
                portion.getPortionFormat().setFontHeight(18);
            }
        }
    }
    // حفظ ملف PPTX إلى القرص
    pres.save("multiParaPort_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

إدارة تعداد الفقرات

تساعد القوائم النقطية في تنظيم وعرض المعلومات بسرعة وكفاءة. الفقرات ذات التعداد النقطي تكون دائمًا أسهل في القراءة والفهم.

1. إنشاء مثال من فئة Presentation.
2. الوصول إلى مرجع الشريحة ذات الصلة عبر رقم الفهرس الخاص بها.
3. إضافة AutoShape إلى الشريحة المختارة.
4. الوصول إلى [TextFrame] الخاص بـ autoshape.
5. إزالة الفقرة الافتراضية في TextFrame.
6. إنشاء أول مثال للفقرة باستخدام الفئة Paragraph.
7. تعيين خاصية Type لتعداد الفقرة إلى Symbol وتحديد حرف التعداد.
8. تعيين Text للفقرة.
9. تعيين Indent للفقرة بالنسبة للتعداد.
10. تحديد لون للتعداد.
11. تحديد ارتفاع للتعداد.
12. إضافة الفقرة الجديدة إلى مجموعة فقرات TextFrame.
13. إضافة الفقرة الثانية وتكرار العملية المذكورة في الخطوات من 7 إلى 13.
14. حفظ العرض التقديمي.

// ينشئ كائن من فئة Presentation يمثل ملف PPTX
var pres = new aspose.slides.Presentation();
try {
    // يصل إلى الشريحة الأولى
    var slide = pres.getSlides().get_Item(0);
    // يضيف ويصل إلى AutoShape
    var aShp = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 200, 200, 400, 200);
    // يصل إلى إطار النص الخاص بالـ AutoShape
    var txtFrm = aShp.getTextFrame();
    // يزيل الفقرة الافتراضية
    txtFrm.getParagraphs().removeAt(0);
    // ينشئ فقرة
    var para = new aspose.slides.Paragraph();
    // يحدد نمط نقطة الفقرة والرمز
    para.getParagraphFormat().getBullet().setType(aspose.slides.BulletType.Symbol);
    para.getParagraphFormat().getBullet().setChar(8226);
    // يحدد نص الفقرة
    para.setText("Welcome to Aspose.Slides");
    // يحدد مسافة إزاحة النقطة
    para.getParagraphFormat().setIndent(25);
    // يحدد لون النقطة
    para.getParagraphFormat().getBullet().getColor().setColorType(aspose.slides.ColorType.RGB);
    para.getParagraphFormat().getBullet().getColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLACK"));
    para.getParagraphFormat().getBullet().setBulletHardColor(aspose.slides.NullableBool.True);// تعيين IsBulletHardColor إلى true لاستخدام لون نقطتك الخاصة
    // يحدد ارتفاع النقطة
    para.getParagraphFormat().getBullet().setHeight(100);
    // يضيف الفقرة إلى إطار النص
    txtFrm.getParagraphs().add(para);
    // ينشئ الفقرة الثانية
    var para2 = new aspose.slides.Paragraph();
    // يحدد نوع النقطة للفقرة والنمط
    para2.getParagraphFormat().getBullet().setType(aspose.slides.BulletType.Numbered);
    para2.getParagraphFormat().getBullet().setNumberedBulletStyle(aspose.slides.NumberedBulletStyle.BulletCircleNumWDBlackPlain);
    // يضيف نص الفقرة
    para2.setText("This is numbered bullet");
    // يحدد مسافة إزاحة النقطة
    para2.getParagraphFormat().setIndent(25);
    para2.getParagraphFormat().getBullet().getColor().setColorType(aspose.slides.ColorType.RGB);
    para2.getParagraphFormat().getBullet().getColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLACK"));
    para2.getParagraphFormat().getBullet().setBulletHardColor(aspose.slides.NullableBool.True);// تعيين IsBulletHardColor إلى true لاستخدام لون نقطتك الخاصة
    // يحدد ارتفاع النقطة
    para2.getParagraphFormat().getBullet().setHeight(100);
    // يضيف الفقرة إلى إطار النص
    txtFrm.getParagraphs().add(para2);
    // يحفظ العرض التقديمي المعدل
    pres.save("Bullet_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

إدارة تعداد الصور

تساعد القوائم النقطية في تنظيم وعرض المعلومات بسرعة وكفاءة. الفقرات ذات الصور سهلة القراءة والفهم.

1. إنشاء مثال من فئة Presentation.
2. الوصول إلى مرجع الشريحة ذات الصلة عبر رقم الفهرس الخاص بها.
3. إضافة AutoShape إلى الشريحة.
4. الوصول إلى [TextFrame] الخاص بـ autoshape.
5. إزالة الفقرة الافتراضية في TextFrame.
6. إنشاء أول مثال للفقرة باستخدام الفئة Paragraph.
7. تحميل الصورة في PPImage.
8. تعيين نوع التعداد إلى Picture وتحديد الصورة.
9. تعيين Text للفقرة.
10. تعيين Indent للفقرة بالنسبة للتعداد.
11. تحديد لون للتعداد.
12. تحديد ارتفاع للتعداد.
13. إضافة الفقرة الجديدة إلى مجموعة فقرات TextFrame.
14. إضافة الفقرة الثانية وتكرار العملية بناءً على الخطوات السابقة.
15. حفظ العرض التقديمي المعدل.

// ينشئ كائن من فئة Presentation يمثل ملف PPTX
var presentation = new aspose.slides.Presentation();
try {
    // الوصول إلى الشريحة الأولى
    var slide = presentation.getSlides().get_Item(0);
    // إنشاء الصورة المستخدمة للنقاط
    var picture;
    var image = aspose.slides.Images.fromFile("bullets.png");
    try {
        picture = presentation.getImages().addImage(image);
    } finally {
        if (image != null) {
            image.dispose();
        }
    }
    // إضافة والوصول إلى AutoShape
    var autoShape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 200, 200, 400, 200);
    // الوصول إلى إطار النص للـ AutoShape
    var textFrame = autoShape.getTextFrame();
    // إزالة الفقرة الافتراضية
    textFrame.getParagraphs().removeAt(0);
    // إنشاء فقرة جديدة
    var paragraph = new aspose.slides.Paragraph();
    paragraph.setText("Welcome to Aspose.Slides");
    // تعيين نمط نقطة الفقرة والصورة
    paragraph.getParagraphFormat().getBullet().setType(aspose.slides.BulletType.Picture);
    paragraph.getParagraphFormat().getBullet().getPicture().setImage(picture);
    // تعيين ارتفاع النقطة
    paragraph.getParagraphFormat().getBullet().setHeight(100);
    // إضافة الفقرة إلى إطار النص
    textFrame.getParagraphs().add(paragraph);
    // حفظ العرض التقديمي كملف PPTX
    presentation.save("ParagraphPictureBulletsPPTX_out.pptx", aspose.slides.SaveFormat.Pptx);
    // حفظ العرض التقديمي كملف PPT
    presentation.save("ParagraphPictureBulletsPPT_out.ppt", aspose.slides.SaveFormat.Ppt);
} catch (e) {console.log(e);
} finally {
    if (presentation != null) {
        presentation.dispose();
    }
}

إدارة تعداد متعدد المستويات

تساعد القوائم النقطية في تنظيم وعرض المعلومات بسرعة وكفاءة. التعداد متعدد المستويات سهل القراءة والفهم.

1. إنشاء مثال من فئة Presentation.
2. الوصول إلى مرجع الشريحة ذات الصلة عبر رقم الفهرس الخاص بها.
3. إضافة AutoShape في الشريحة الجديدة.
4. الوصول إلى [TextFrame] الخاص بـ autoshape.
5. إزالة الفقرة الافتراضية في TextFrame.
6. إنشاء أول مثال للفقرة عبر الفئة Paragraph وتعيين العمق إلى 0.
7. إنشاء مثال الفقرة الثانية عبر الفئة Paragraph وتعيين العمق إلى 1.
8. إنشاء مثال الفقرة الثالثة عبر الفئة Paragraph وتعيين العمق إلى 2.
9. إنشاء مثال الفقرة الرابعة عبر الفئة Paragraph وتعيين العمق إلى 3.
10. إضافة الفقرات الجديدة إلى مجموعة فقرات TextFrame.
11. حفظ العرض التقديمي المعدل.

// ينشئ كائن من فئة Presentation يمثل ملف PPTX
var pres = new aspose.slides.Presentation();
try {
    // الوصول إلى الشريحة الأولى
    var slide = pres.getSlides().get_Item(0);
    // يضيف ويصل إلى AutoShape
    var aShp = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 200, 200, 400, 200);
    // الوصول إلى إطار النص للـ AutoShape المُنشأ
    var text = aShp.addTextFrame("");
    // مسح الفقرة الافتراضية
    text.getParagraphs().clear();
    // إضافة الفقرة الأولى
    var para1 = new aspose.slides.Paragraph();
    para1.setText("Content");
    para1.getParagraphFormat().getBullet().setType(aspose.slides.BulletType.Symbol);
    para1.getParagraphFormat().getBullet().setChar(8226);
    para1.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    para1.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLACK"));
    // تحديد مستوى النقطة
    para1.getParagraphFormat().setDepth(0);
    // إضافة الفقرة الثانية
    var para2 = new aspose.slides.Paragraph();
    para2.setText("Second Level");
    para2.getParagraphFormat().getBullet().setType(aspose.slides.BulletType.Symbol);
    para2.getParagraphFormat().getBullet().setChar('-');
    para2.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    para2.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLACK"));
    // تحديد مستوى النقطة
    para2.getParagraphFormat().setDepth(1);
    // إضافة الفقرة الثالثة
    var para3 = new aspose.slides.Paragraph();
    para3.setText("Third Level");
    para3.getParagraphFormat().getBullet().setType(aspose.slides.BulletType.Symbol);
    para3.getParagraphFormat().getBullet().setChar(8226);
    para3.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    para3.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLACK"));
    // تحديد مستوى النقطة
    para3.getParagraphFormat().setDepth(2);
    // إضافة الفقرة الرابعة
    var para4 = new aspose.slides.Paragraph();
    para4.setText("Fourth Level");
    para4.getParagraphFormat().getBullet().setType(aspose.slides.BulletType.Symbol);
    para4.getParagraphFormat().getBullet().setChar('-');
    para4.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    para4.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLACK"));
    // تحديد مستوى النقطة
    para4.getParagraphFormat().setDepth(3);
    // إضافة الفقرات إلى المجموعة
    text.getParagraphs().add(para1);
    text.getParagraphs().add(para2);
    text.getParagraphs().add(para3);
    text.getParagraphs().add(para4);
    // حفظ العرض التقديمي كملف PPTX
    pres.save("MultilevelBullet.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

إدارة الفقرة مع قائمة مرقمة مخصصة

توفر الفئة BulletFormat الخاصية NumberedBulletStartWith وغيرها التي تسمح لك بإدارة الفقرات بأرقام مخصصة أو تنسيق مخصص.

1. إنشاء مثال من فئة Presentation.
2. الوصول إلى الشريحة التي تحتوي على الفقرة.
3. إضافة AutoShape إلى الشريحة.
4. الوصول إلى [TextFrame] الخاص بـ autoshape.
5. إزالة الفقرة الافتراضية في TextFrame.
6. إنشاء أول مثال للفقرة عبر الفئة Paragraph وتعيين NumberedBulletStartWith إلى 2.
7. إنشاء مثال الفقرة الثانية عبر الفئة Paragraph وتعيين NumberedBulletStartWith إلى 3.
8. إنشاء مثال الفقرة الثالثة عبر الفئة Paragraph وتعيين NumberedBulletStartWith إلى 7.
9. إضافة الفقرات الجديدة إلى مجموعة فقرات TextFrame.
10. حفظ العرض التقديمي المعدل.

var presentation = new aspose.slides.Presentation();
try {
    var shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 200, 200, 400, 200);
    // الوصول إلى إطار النص للـ AutoShape المنشأ
    var textFrame = shape.getTextFrame();
    // إزالة الفقرة الافتراضية الموجودة
    textFrame.getParagraphs().removeAt(0);
    // القائمة الأولى
    var paragraph1 = new aspose.slides.Paragraph();
    paragraph1.setText("bullet 2");
    paragraph1.getParagraphFormat().setDepth(4);
    paragraph1.getParagraphFormat().getBullet().setNumberedBulletStartWith(2);
    paragraph1.getParagraphFormat().getBullet().setType(aspose.slides.BulletType.Numbered);
    textFrame.getParagraphs().add(paragraph1);
    var paragraph2 = new aspose.slides.Paragraph();
    paragraph2.setText("bullet 3");
    paragraph2.getParagraphFormat().setDepth(4);
    paragraph2.getParagraphFormat().getBullet().setNumberedBulletStartWith(3);
    paragraph2.getParagraphFormat().getBullet().setType(aspose.slides.BulletType.Numbered);
    textFrame.getParagraphs().add(paragraph2);
    var paragraph5 = new aspose.slides.Paragraph();
    paragraph5.setText("bullet 7");
    paragraph5.getParagraphFormat().setDepth(4);
    paragraph5.getParagraphFormat().getBullet().setNumberedBulletStartWith(7);
    paragraph5.getParagraphFormat().getBullet().setType(aspose.slides.BulletType.Numbered);
    textFrame.getParagraphs().add(paragraph5);
    presentation.save("SetCustomBulletsNumber-slides.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (presentation != null) {
        presentation.dispose();
    }
}

تعيين إزاحة الفقرة

1. إنشاء مثال من فئة Presentation.
2. الوصول إلى مرجع الشريحة ذات الصلة عبر رقم الفهرس الخاص بها.
3. إضافة AutoShape على شكل مستطيل إلى الشريحة.
4. إضافة TextFrame يحتوي على ثلاث فقرات إلى الشكل المستطيل.
5. إخفاء خطوط المستطيل.
6. تعيين الإزاحة لكل [Paragraph] عبر خاصية BulletOffset الخاصة بها.
7. حفظ العرض التقديمي المعدل كملف PPT.

// إنشاء فئة Presentation
var pres = new aspose.slides.Presentation();
try {
    // الحصول على الشريحة الأولى
    var sld = pres.getSlides().get_Item(0);
    // إضافة شكل مستطيل
    var rect = sld.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 100, 100, 500, 150);
    // إضافة TextFrame إلى المستطيل
    var tf = rect.addTextFrame("This is first line \rThis is second line \rThis is third line");
    // ضبط النص ليناسب الشكل
    tf.getTextFrameFormat().setAutofitType(aspose.slides.TextAutofitType.Shape);
    // إخفاء خطوط المستطيل
    rect.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    // الحصول على الفقرة الأولى في TextFrame وتعيين إزاحتها
    var para1 = tf.getParagraphs().get_Item(0);
    // تعيين نمط نقطة الفقرة والرمز
    para1.getParagraphFormat().getBullet().setType(aspose.slides.BulletType.Symbol);
    para1.getParagraphFormat().getBullet().setChar(8226);
    para1.getParagraphFormat().setAlignment(aspose.slides.TextAlignment.Left);
    para1.getParagraphFormat().setDepth(2);
    para1.getParagraphFormat().setIndent(30);
    // الحصول على الفقرة الثانية في TextFrame وتعيين إزاحتها
    var para2 = tf.getParagraphs().get_Item(1);
    para2.getParagraphFormat().getBullet().setType(aspose.slides.BulletType.Symbol);
    para2.getParagraphFormat().getBullet().setChar(8226);
    para2.getParagraphFormat().setAlignment(aspose.slides.TextAlignment.Left);
    para2.getParagraphFormat().setDepth(2);
    para2.getParagraphFormat().setIndent(40);
    // الحصول على الفقرة الثالثة في TextFrame وتعيين إزاحتها
    var para3 = tf.getParagraphs().get_Item(2);
    para3.getParagraphFormat().getBullet().setType(aspose.slides.BulletType.Symbol);
    para3.getParagraphFormat().getBullet().setChar(8226);
    para3.getParagraphFormat().setAlignment(aspose.slides.TextAlignment.Left);
    para3.getParagraphFormat().setDepth(2);
    para3.getParagraphFormat().setIndent(50);
    // كتابة العرض التقديمي إلى القرص
    pres.save("InOutDent_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

تعيين إزاحة معلقة للفقرة

var pres = new aspose.slides.Presentation();
try {
    var autoShape = pres.getSlides().get_Item(0).getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 50, 250, 550, 150);
    var para1 = new aspose.slides.Paragraph();
    para1.setText("Example");
    var para2 = new aspose.slides.Paragraph();
    para2.setText("Set Hanging Indent for Paragraph");
    var para3 = new aspose.slides.Paragraph();
    para3.setText("This code shows you how to set the hanging indent for a paragraph: ");
    para2.getParagraphFormat().setMarginLeft(10.0);
    para3.getParagraphFormat().setMarginLeft(20.0);
    autoShape.getTextFrame().getParagraphs().add(para1);
    autoShape.getTextFrame().getParagraphs().add(para2);
    autoShape.getTextFrame().getParagraphs().add(para3);
    pres.save("pres.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

إدارة خصائص تشغيل نهاية الفقرة للفقرة

1. إنشاء مثال من فئة Presentation.
2. الحصول على مرجع الشريحة التي تحتوي على الفقرة عبر موقعها.
3. إضافة AutoShape على شكل مستطيل إلى الشريحة.
4. إضافة TextFrame يحتوي على فقرتين إلى المستطيل.
5. تعيين FontHeight ونوع الخط للفقرتين.
6. تعيين خصائص End للفقرتين.
7. حفظ العرض التقديمي المعدل كملف PPTX.

var pres = new aspose.slides.Presentation();
try {
    var shape = pres.getSlides().get_Item(0).getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 10, 10, 200, 250);
    var para1 = new aspose.slides.Paragraph();
    para1.getPortions().add(new aspose.slides.Portion("Sample text"));
    var para2 = new aspose.slides.Paragraph();
    para2.getPortions().add(new aspose.slides.Portion("Sample text 2"));
    var portionFormat = new aspose.slides.PortionFormat();
    portionFormat.setFontHeight(48);
    portionFormat.setLatinFont(new aspose.slides.FontData("Times New Roman"));
    para2.setEndParagraphPortionFormat(portionFormat);
    shape.getTextFrame().getParagraphs().add(para1);
    shape.getTextFrame().getParagraphs().add(para2);
    pres.save(resourcesOutputPath + "pres.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

استيراد نص HTML إلى الفقرات

توفر Aspose.Slides دعمًا محسنًا لاستيراد نص HTML إلى الفقرات.

1. إنشاء مثال من فئة Presentation.
2. الوصول إلى مرجع الشريحة ذات الصلة عبر رقم الفهرس الخاص بها.
3. إضافة AutoShape إلى الشريحة.
4. إضافة والوصول إلى [TextFrame] الخاص بـ AutoShape.
5. إزالة الفقرة الافتراضية في TextFrame.
6. قراءة ملف HTML المصدر باستخدام TextReader.
7. إنشاء أول مثال للفقرة عبر الفئة Paragraph.
8. إضافة محتوى ملف HTML المقروء من TextReader إلى [ParagraphCollection] الخاص بـ TextFrame.
9. حفظ العرض التقديمي المعدل.

// إنشاء مثيل عرض تقديمي فارغ
var pres = new aspose.slides.Presentation();
try {
    // الوصول إلى الشريحة الأولى الافتراضية للعرض التقديمي
    var slide = pres.getSlides().get_Item(0);
    // إضافة AutoShape لاستيعاب محتوى HTML
    var ashape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 10, 10, pres.getSlideSize().getSize().getWidth() - 20, pres.getSlideSize().getSize().getHeight() - 10);
    ashape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
    // إضافة إطار نص إلى الشكل
    ashape.addTextFrame("");
    // مسح جميع الفقرات في إطار النص المضاف
    ashape.getTextFrame().getParagraphs().clear();
    // تحميل ملف HTML باستخدام قارئ التدفق
    var tr = java.newInstanceSync("StreamReader", "file.html");
    // إضافة النص من قارئ تدفق HTML إلى إطار النص
    ashape.getTextFrame().getParagraphs().addFromHtml(tr.readToEnd());
    // حفظ العرض التقديمي
    pres.save("output.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

تصدير نص الفقرات إلى HTML

توفر Aspose.Slides دعمًا محسنًا لتصدير النصوص (الموجودة في الفقرات) إلى HTML.

1. إنشاء مثال من فئة Presentation وتحميل العرض التقديمي المطلوب.
2. الوصول إلى مرجع الشريحة ذات الصلة عبر رقم الفهرس الخاص بها.
3. الوصول إلى الشكل الذي يحتوي على النص الذي سيُصدّر إلى HTML.
4. الوصول إلى [TextFrame] الخاص بالشكل.
5. إنشاء مثال من StreamWriter وإضافة ملف HTML جديد.
6. تحديد فهرس بداية لـ StreamWriter وتصدير الفقرات المفضلة.

// تحميل ملف العرض التقديمي
var pres = new aspose.slides.Presentation("ExportingHTMLText.pptx");
try {
    // الوصول إلى الشريحة الأولى الافتراضية في العرض التقديمي
    var slide = pres.getSlides().get_Item(0);
    // الفهرس المطلوب
    var index = 0;
    // الوصول إلى الشكل المضاف
    var ashape = slide.getShapes().get_Item(index);
    // إنشاء ملف HTML الناتج
    var os = java.newInstanceSync("java.io.FileOutputStream", "output.html");
    var writer = java.newInstanceSync("java.io.OutputStreamWriter", os, "UTF-8");
    // استخراج الفقرة الأولى كـ HTML
    // كتابة بيانات الفقرات إلى HTML عن طريق تحديد فهرس بدء الفقرة وإجمالي الفقرات التي سيتم نسخها
    writer.write(ashape.getTextFrame().getParagraphs().exportToHtml(0, ashape.getTextFrame().getParagraphs().getCount(), null));
    writer.close();
} catch (e) {console.log(e);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

حفظ الفقرة كصورة

في هذا القسم، سوف نستعرض مثالين يوضحان كيفية حفظ فقرة نصية، ممثلة بالفئة Paragraph، كصورة. يتضمن كل مثال الحصول على صورة الشكل الذي يحتوي الفقرة باستخدام أساليب getImage من الفئة Shape، حساب حدود الفقرة داخل الشكل، وتصديرها كصورة bitmap. تسمح هذه الأساليب باستخراج أجزاء محددة من النص من عروض PowerPoint وحفظها كصور منفصلة، وهو ما قد يكون مفيدًا لاستخدامات متعددة.

لنفترض أن لدينا ملف عرض تقديمي اسمه sample.pptx يحتوي شريحة واحدة، حيث يكون الشكل الأول مربع نص يحتوي على ثلاث فقرات.

مثال 1

في هذا المثال، نحصل على الفقرة الثانية كصورة. للقيام بذلك، نستخرج صورة الشكل من الشريحة الأولى للعرض التقديمي ثم نحسب حدود الفقرة الثانية داخل إطار النص الخاص بالشكل. بعد ذلك تُعاد رسم الفقرة على صورة bitmap جديدة تُحفظ بصيغة PNG. هذه الطريقة مفيدة خاصة عندما تحتاج إلى حفظ فقرة محددة كصورة منفصلة مع الحفاظ على الأبعاد والتنسيق الدقيق للنص.

const imageio = java.import("javax.imageio.ImageIO");
const presentation = new aspose.slides.Presentation("sample.pptx");
try {
    const firstShape = presentation.getSlides().get_Item(0).getShapes().get_Item(0);

    // احفظ الشكل في الذاكرة كصورة bitmap.
    const shapeImage = firstShape.getImage();
        
    const shapeImageStream = java.newInstanceSync("java.io.ByteArrayOutputStream");
    shapeImage.save(shapeImageStream, aspose.slides.ImageFormat.Png);
    shapeImage.dispose();
    shapeImageStream.flush();
    
    // أنشئ صورة bitmap للشكل من الذاكرة.
    const byteBuffer = java.callMethodSync(shapeImageStream, "toByteArray");    
    const javaBytes = java.newArray("byte", Array.from(byteBuffer));
    const ByteArrayInputStream = java.import("java.io.ByteArrayInputStream");
    const shapeImageInputStream = new ByteArrayInputStream(javaBytes);
    const shapeBitmap = imageio.read(shapeImageInputStream);

    // احسب حدود الفقرة الثانية.
    const secondParagraph = firstShape.getTextFrame().getParagraphs().get_Item(1);
    const paragraphRectangle = secondParagraph.getRect();

    // احسب الإحداثيات والحجم للصورة الناتجة (الحد الأدنى - بكسل واحد 1x1).
    const imageX = Math.floor(paragraphRectangle.getX());
    const imageY = Math.floor(paragraphRectangle.getY());
    const imageWidth = Math.max(1, Math.ceil(paragraphRectangle.getWidth()));
    const imageHeight = Math.max(1, Math.ceil(paragraphRectangle.getHeight()));

    // قم بقص صورة bitmap للشكل للحصول فقط على صورة bitmap للفقرة.
    const paragraphBitmap = shapeBitmap.getSubimage(imageX, imageY, imageWidth, imageHeight);

    const file = java.newInstanceSync("java.io.File", "paragraph.png");

    imageio.write(paragraphBitmap, "png", file);
} finally {
    if (presentation != null) {
        presentation.dispose();
    }
}

النتيجة:

مثال 2

في هذا المثال، نوسّع النهج السابق بإضافة عوامل تكبير إلى صورة الفقرة. يُستخرج الشكل من العرض التقديمي ويحفظ كصورة بمعامل تكبير 2. هذا يسمح بالحصول على إخراج بدقة أعلى عند تصدير الفقرة. بعدها تُحسب حدود الفقرة مع الأخذ في الاعتبار عامل التكبير. يمكن أن يكون التكبير مفيدًا عندما تكون هناك حاجة إلى صورة ذات تفاصيل أكثر، مثلاً للاستخدام في مواد مطبوعة عالية الجودة.

const imageScaleX = 2;
const imageScaleY = imageScaleX;

const imageio = java.import("javax.imageio.ImageIO");
const presentation = new aspose.slides.Presentation("sample.pptx");
try {
    const firstShape = presentation.getSlides().get_Item(0).getShapes().get_Item(0);

    // احفظ الشكل في الذاكرة كصورة bitmap مع التحجيم.
    const shapeImage = firstShape.getImage(aspose.slides.ShapeThumbnailBounds.Shape, imageScaleX, imageScaleY);
    const shapeImageStream = java.newInstanceSync("java.io.ByteArrayOutputStream");
    shapeImage.save(shapeImageStream, aspose.slides.ImageFormat.Png);
    shapeImage.dispose();

    // أنشئ صورة bitmap للشكل من الذاكرة.
    const byteBuffer = java.callMethodSync(shapeImageStream, "toByteArray");    
    const javaBytes = java.newArray("byte", Array.from(byteBuffer));
    const ByteArrayInputStream = java.import("java.io.ByteArrayInputStream");
    const shapeImageInputStream = new ByteArrayInputStream(javaBytes);
    const shapeBitmap = imageio.read(shapeImageInputStream);

    // احسب حدود الفقرة الثانية.
    const secondParagraph = firstShape.getTextFrame().getParagraphs().get_Item(1);
    const paragraphRectangle = secondParagraph.getRect();
    paragraphRectangle.setRect(
            paragraphRectangle.getX() * imageScaleX,
            paragraphRectangle.getY() * imageScaleY,
            paragraphRectangle.getWidth() * imageScaleX,
            paragraphRectangle.getHeight() * imageScaleY
    );

    // احسب الإحداثيات والحجم للصورة الناتجة (الحد الأدنى - بكسل واحد 1x1).
    const imageX = Math.floor(paragraphRectangle.getX());
    const imageY = Math.floor(paragraphRectangle.getY());
    const imageWidth = Math.max(1, Math.ceil(paragraphRectangle.getWidth()));
    const imageHeight = Math.max(1, Math.ceil(paragraphRectangle.getHeight()));

    // قص صورة bitmap للشكل للحصول فقط على صورة bitmap للفقرة.
    const paragraphBitmap = shapeBitmap.getSubimage(imageX, imageY, imageWidth, imageHeight);

    const file = java.newInstanceSync("java.io.File", "paragraph.png");

    imageio.write(paragraphBitmap, "png", file);
} finally {
    if (presentation != null) {
        presentation.dispose();
    }
}

الأسئلة الشائعة

هل يمكنني تعطيل الالتفاف السطري داخل إطار النص تمامًا؟

نعم. استخدم إعداد الالتفاف في إطار النص (setWrapText) لإيقاف الالتفاف بحيث لا تنكسر السطور عند حدود الإطار.

كيف يمكنني الحصول على الحدود الدقيقة للفقرة المحددة على الشريحة؟

يمكنك استرجاع مستطيل الحدود للفقرة (وحتى جزء واحد) لمعرفة موقعها وحجمها الدقيق على الشريحة.

أين يتم التحكم في محاذاة الفقرة (يسار/يمين/وسط/ضبط)؟

setAlignment هو طريقة لضبط محاذاة على مستوى الفقرة في ParagraphFormat; وتطبق على الفقرة بأكملها بغض النظر عن تنسيق الأجزاء الفردية.

هل يمكنني تحديد لغة تدقق إملائي لجزء فقط من الفقرة (مثل كلمة واحدة)؟

نعم. يتم تعيين اللغة على مستوى الجزء (PortionFormat.setLanguageId)، لذا يمكن أن تتعايش لغات متعددة داخل فقرة واحدة.