PowerPoint szövegbekezdések kezelése Java-ban

Bevezetés

Az Aspose.Slides minden interfészt és osztályt biztosít, amelyre a PowerPoint szövegek, bekezdések és részek Java nyelven történő kezeléséhez szüksége van.

• Az Aspose.Slides biztosítja a ITextFrame interfészt, amely lehetővé teszi, hogy bekezdést képviselő objektumokat adjunk hozzá. Egy ITextFame objektumnak lehet egy vagy több bekezdése (minden bekezdés egy sortörés segítségével jön létre).
• Az Aspose.Slides biztosítja a IParagraph interfészt, amely lehetővé teszi, hogy részeket képviselő objektumokat adjunk hozzá. Egy IParagraph objektumnak lehet egy vagy több rész (az iPortions objektumok gyűjteménye).
• Az Aspose.Slides biztosítja a IPortion interfészt, amely lehetővé teszi, hogy szövegeket és azok formázási tulajdonságait képviselő objektumokat adjunk hozzá.

Egy IParagraph objektum képes különböző formázási tulajdonságú szövegeket kezelni az alatta lévő IPortion objektumok segítségével.

Több bekezdés hozzáadása, amelyek több részt tartalmaznak

Az alábbi lépések megmutatják, hogyan adhatunk hozzá egy szövegkeretet, amely 3 bekezdést tartalmaz, és minden bekezdés 3 részt tartalmaz:

1. Hozzon létre egy példányt a Presentation osztályból.
2. A megfelelő diára hivatkozást érje el az indexe alapján.
3. Adjon hozzá egy téglalap IAutoShape alakzatot a diára.
4. Szerezze meg a IAutoShape-hez társított ITextFrame-et.
5. Hozzon létre két IParagraph objektumot, és adja hozzá az ITextFrame-nek a IParagraphs gyűjteményéhez.
6. Minden új IParagraph-hez hozzon létre három IPortion objektumot (alapértelmezett bekezdéshez két Portion objektumot), és adja hozzá az egyes IPortion objektumokat az adott IParagraph IPortion gyűjteményéhez.
7. Állítson be szöveget minden részhez.
8. Alkalmazza a kívánt formázási beállításokat minden részre a IPortion objektum által biztosított formázási tulajdonságok segítségével.
9. Mentse el a módosított prezentációt.

// PPTX fájlt képviselő Presentation osztály példányosítása
Presentation pres = new Presentation();
try {
    // Az első dia elérése
    ISlide slide = pres.getSlides().get_Item(0);

    // Rectangle típusú AutoShape hozzáadása
    IAutoShape ashp = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 150, 300, 150);

    // Az AutoShape TextFrame-ének elérése
    ITextFrame tf = ashp.getTextFrame();

    // Bekezdések és részek létrehozása különböző szövegformátumokkal
    IParagraph para0 = tf.getParagraphs().get_Item(0);
    IPortion port01 = new Portion();
    IPortion port02 = new Portion();
    para0.getPortions().add(port01);
    para0.getPortions().add(port02);

    IParagraph para1 = new Paragraph();
    tf.getParagraphs().add(para1);
    IPortion port10 = new Portion();
    IPortion port11 = new Portion();
    IPortion port12 = new Portion();
    para1.getPortions().add(port10);
    para1.getPortions().add(port11);
    para1.getPortions().add(port12);

    IParagraph para2 = new Paragraph();
    tf.getParagraphs().add(para2);
    IPortion port20 = new Portion();
    IPortion port21 = new Portion();
    IPortion port22 = new Portion();
    para2.getPortions().add(port20);
    para2.getPortions().add(port21);
    para2.getPortions().add(port22);

    for (int i = 0; i < 3; i++) 
    {
        for (int j = 0; j < 3; j++) 
        {
            IPortion portion = tf.getParagraphs().get_Item(i).getPortions().get_Item(j); 
            portion.setText("Portion0" + j);
            if (j == 0) {
                portion.getPortionFormat().getFillFormat().setFillType(FillType.Solid);
                portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.RED);
                portion.getPortionFormat().setFontBold(NullableBool.True);
                portion.getPortionFormat().setFontHeight(15);
            } else if (j == 1) {
                portion.getPortionFormat().getFillFormat().setFillType(FillType.Solid);
                portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE);
                portion.getPortionFormat().setFontItalic(NullableBool.True);
                portion.getPortionFormat().setFontHeight(18);
            }
        }
    }

    // PPTX írása a lemezre
    pres.save("multiParaPort_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Bekezdés felsorolások kezelése

A felsorolások segítenek az információk gyors és hatékony rendszerezésében és bemutatásában. A felsorolásos bekezdések mindig könnyebben olvashatók és érthetők.

1. Hozzon létre egy példányt a Presentation osztályból.
2. A megfelelő diára hivatkozást érje el az indexe alapján.
3. Adjon hozzá egy autoshape alakzatot a kiválasztott diára.
4. Érje el az autoshape TextFrame elemét.
5. Távolítsa el az alapértelmezett bekezdést a TextFrame-ből.
6. Hozza létre az első bekezdés példányát a Paragraph osztály segítségével.
7. Állítsa be a bekezdés bullet Type-ját Symbol-ra, és adja meg a bullet karaktert.
8. Állítsa be a bekezdés Text értékét.
9. Állítsa be a bekezdés Indent értékét a bullethez.
10. Állítson be színt a bulletnek.
11. Állítson be magasságot a bulletnek.
12. Adja hozzá az új bekezdést a TextFrame bekezdéggyűjteményéhez.
13. Adja hozzá a második bekezdést, és ismételje meg a 7‑13. lépésekben leírt folyamatot.
14. Mentse el a prezentációt.

// PPTX fájlt képviselő Presentation osztály példányosítása
Presentation pres = new Presentation();
try {
    // Az első dia elérése
    ISlide slide = pres.getSlides().get_Item(0);
    
    // Autoshape hozzáadása és elérése
    IAutoShape aShp = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);

    // Az autoshape szövegkeretének elérése
    ITextFrame txtFrm = aShp.getTextFrame();

    // Az alapértelmezett bekezdés eltávolítása
    txtFrm.getParagraphs().removeAt(0);

    // Bekezdés létrehozása
    Paragraph para = new Paragraph();

    // Bekezdés bullet stílusának és szimbólumának beállítása
    para.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    para.getParagraphFormat().getBullet().setChar((char)8226);

    // Bekezdés szövegének beállítása
    para.setText("Welcome to Aspose.Slides");

    // Bullet behúzás beállítása
    para.getParagraphFormat().setIndent(25);

    // Bullet szín beállítása
    para.getParagraphFormat().getBullet().getColor().setColorType(ColorType.RGB);
    para.getParagraphFormat().getBullet().getColor().setColor(Color.BLACK);
    para.getParagraphFormat().getBullet().setBulletHardColor(NullableBool.True); // állítsa az IsBulletHardColor értékét true-ra saját bullet szín használatához

    // Bullet magasság beállítása
    para.getParagraphFormat().getBullet().setHeight(100);

    // Bekezdés hozzáadása a szövegkerethez
    txtFrm.getParagraphs().add(para);

    // Második bekezdés létrehozása
    Paragraph para2 = new Paragraph();

    // Bekezdés bullet típusának és stílusának beállítása
    para2.getParagraphFormat().getBullet().setType(BulletType.Numbered);
    para2.getParagraphFormat().getBullet().setNumberedBulletStyle(NumberedBulletStyle.BulletCircleNumWDBlackPlain);

    // Bekezdés szövegének hozzáadása
    para2.setText("This is numbered bullet");

    // Bullet behúzás beállítása
    para2.getParagraphFormat().setIndent(25);

    para2.getParagraphFormat().getBullet().getColor().setColorType(ColorType.RGB);
    para2.getParagraphFormat().getBullet().getColor().setColor(Color.BLACK);
    para2.getParagraphFormat().getBullet().setBulletHardColor(NullableBool.True); // állítsa az IsBulletHardColor értékét true-ra saját bullet szín használatához

    // Bullet magasság beállítása
    para2.getParagraphFormat().getBullet().setHeight(100);

    // Bekezdés hozzáadása a szövegkerethez
    txtFrm.getParagraphs().add(para2);
    
    // A módosított prezentáció mentése
    pres.save("Bullet_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Képes felsorolások kezelése

Felsorolások segítenek az információk gyors és hatékony rendszerezésében és bemutatásában. A képes bekezdések könnyen olvashatók és érthetők.

1. Hozzon létre egy példányt a Presentation osztályból.
2. A megfelelő diára hivatkozást érje el az indexe alapján.
3. Adjon hozzá egy autoshape alakzatot a diára.
4. Érje el az autoshape TextFrame elemét.
5. Távolítsa el az alapértelmezett bekezdést a TextFrame-ből.
6. Hozza létre az első bekezdés példányát a Paragraph osztály segítségével.
7. Töltse be a képet a IPPImage segítségével.
8. Állítsa be a bullet típusát Picture értékre, és adja meg a képet.
9. Állítsa be a Paragraph Text értékét.
10. Állítsa be a Paragraph Indent értékét a bullethez.
11. Állítson be színt a bulletnek.
12. Állítson be magasságot a bulletnek.
13. Adja hozzá az új bekezdést a TextFrame bekezdéggyűjteményéhez.
14. Adja hozzá a második bekezdést, és ismételje meg a korábbi lépések alapján a folyamatot.
15. Mentse el a módosított prezentációt.

// PPTX fájlt képviselő Presentation osztály példányosítása
Presentation presentation = new Presentation();
try {
    // Az első dia elérése
    ISlide slide = presentation.getSlides().get_Item(0);

    // A bulletokhoz használt kép példányosítása
    IPPImage picture;
    IImage image = Images.fromFile("bullets.png");
    try {
        picture = presentation.getImages().addImage(image);
    } finally {
        if (image != null) image.dispose();
    }
    // Autoshape hozzáadása és elérése
    IAutoShape autoShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);

    // Az autoshape szövegkeretének elérése
    ITextFrame textFrame = autoShape.getTextFrame();

    // Az alapértelmezett bekezdés eltávolítása
    textFrame.getParagraphs().removeAt(0);

    // Új bekezdés létrehozása
    Paragraph paragraph = new Paragraph();
    paragraph.setText("Welcome to Aspose.Slides");

    // Bekezdés bullet stílusának és képének beállítása
    paragraph.getParagraphFormat().getBullet().setType(BulletType.Picture);
    paragraph.getParagraphFormat().getBullet().getPicture().setImage(picture);

    // Bullet magasság beállítása
    paragraph.getParagraphFormat().getBullet().setHeight(100);

    // Bekezdés hozzáadása a szövegkerethez
    textFrame.getParagraphs().add(paragraph);

    // Prezentáció mentése PPTX fájlként
    presentation.save("ParagraphPictureBulletsPPTX_out.pptx", SaveFormat.Pptx);

    // Prezentáció mentése PPT fájlként
    presentation.save("ParagraphPictureBulletsPPT_out.ppt", SaveFormat.Ppt);
} catch (IOException e) {
} finally {
    if (presentation != null) presentation.dispose();
}

Többszintű felsorolások kezelése

Felsorolások segítenek az információk gyors és hatékony rendszerezésében és bemutatásában. A többszintű felsorolások könnyen olvashatók és érthetők.

1. Hozzon létre egy példányt a Presentation osztályból.
2. A megfelelő diára hivatkozást érje el az indexe alapján.
3. Adjon hozzá egy autoshape alakzatot az új diára.
4. Érje el az autoshape TextFrame elemét.
5. Távolítsa el az alapértelmezett bekezdést a TextFrame-ben.
6. Hozza létre az első bekezdést a Paragraph osztály segítségével, és állítsa be a mélységet 0-ra.
7. Hozza létre a második bekezdést a Paragraph osztály segítségével, és állítsa be a mélységet 1-re.
8. Hozza létre a harmadik bekezdést a Paragraph osztály segítségével, és állítsa be a mélységet 2-re.
9. Hozza létre a negyedik bekezdést a Paragraph osztály segítségével, és állítsa be a mélységet 3-ra.
10. Adja hozzá az új bekezdéseket a TextFrame bekezdéggyűjteményéhez.
11. Mentse el a módosított prezentációt.

// PPTX fájlt képviselő Presentation osztály példányosítása
Presentation pres = new Presentation();
try {
    // Az első dia elérése
    ISlide slide = pres.getSlides().get_Item(0);

    // Autoshape hozzáadása és elérése
    IAutoShape aShp = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);

    // A létrehozott autoshape szövegkeretének elérése
    ITextFrame text = aShp.addTextFrame("");

    // Az alapértelmezett bekezdés törlése
    text.getParagraphs().clear();

    // Az első bekezdés hozzáadása
    IParagraph para1 = new Paragraph();
    para1.setText("Content");
    para1.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    para1.getParagraphFormat().getBullet().setChar((char)8226);
    para1.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    para1.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    // Bullet szint beállítása
    para1.getParagraphFormat().setDepth((short)0);

    // A második bekezdés hozzáadása
    IParagraph para2 = new Paragraph();
    para2.setText("Second Level");
    para2.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    para2.getParagraphFormat().getBullet().setChar('-');
    para2.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    para2.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    // Bullet szint beállítása
    para2.getParagraphFormat().setDepth((short)1);

    // A harmadik bekezdés hozzáadása
    IParagraph para3 = new Paragraph();
    para3.setText("Third Level");
    para3.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    para3.getParagraphFormat().getBullet().setChar((char)8226);
    para3.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    para3.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    // Bullet szint beállítása
    para3.getParagraphFormat().setDepth((short)2);

    // A negyedik bekezdés hozzáadása
    IParagraph para4 = new Paragraph();
    para4.setText("Fourth Level");
    para4.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    para4.getParagraphFormat().getBullet().setChar('-');
    para4.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    para4.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    // Bullet szint beállítása
    para4.getParagraphFormat().setDepth((short)3);

    // Bekezdések hozzáadása a gyűjteményhez
    text.getParagraphs().add(para1);
    text.getParagraphs().add(para2);
    text.getParagraphs().add(para3);
    text.getParagraphs().add(para4);

    // A prezentáció mentése PPTX fájlként
    pres.save("MultilevelBullet.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Bekezdés kezelése egy egyéni számozott listával

Az IBulletFormat interfész biztosítja a NumberedBulletStartWith tulajdonságot és egyéb lehetőségeket, amelyek lehetővé teszik a bekezdések egyéni számozásával vagy formázásával való kezelését.

1. Hozzon létre egy példányt a Presentation osztályból.
2. Érje el azt a diát, amely a bekezdést tartalmazza.
3. Adjon hozzá egy autoshape alakzatot a diára.
4. Érje el az autoshape TextFrame elemét.
5. Távolítsa el az alapértelmezett bekezdést a TextFrame-ben.
6. Hozza létre az első bekezdést a Paragraph osztály segítségével, és állítsa be a NumberedBulletStartWith értékét 2-re.
7. Hozza létre a második bekezdést a Paragraph osztály segítségével, és állítsa be a NumberedBulletStartWith értékét 3-ra.
8. Hozza létre a harmadik bekezdést a Paragraph osztály segítségével, és állítsa be a NumberedBulletStartWith értékét 7-re.
9. Adja hozzá az új bekezdéseket a TextFrame bekezdéggyűjteményéhez.
10. Mentse el a módosított prezentációt.

Presentation presentation = new Presentation();
try {
    IAutoShape shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);

    // A létrehozott autoshape szövegkeretének elérése
    ITextFrame textFrame = shape.getTextFrame();

    // Az alapértelmezett létező bekezdés eltávolítása
    textFrame.getParagraphs().removeAt(0);

    // Első lista
    Paragraph paragraph1 = new Paragraph();
    paragraph1.setText("bullet 2");
    paragraph1.getParagraphFormat().setDepth((short)4);
    paragraph1.getParagraphFormat().getBullet().setNumberedBulletStartWith((short)2);
    paragraph1.getParagraphFormat().getBullet().setType(BulletType.Numbered);
    textFrame.getParagraphs().add(paragraph1);

    Paragraph paragraph2 = new Paragraph();
    paragraph2.setText("bullet 3");
    paragraph2.getParagraphFormat().setDepth((short)4);
    paragraph2.getParagraphFormat().getBullet().setNumberedBulletStartWith((short)3);
    paragraph2.getParagraphFormat().getBullet().setType(BulletType.Numbered);
    textFrame.getParagraphs().add(paragraph2);


    Paragraph paragraph5 = new Paragraph();
    paragraph5.setText("bullet 7");
    paragraph5.getParagraphFormat().setDepth((short)4);
    paragraph5.getParagraphFormat().getBullet().setNumberedBulletStartWith((short)7);
    paragraph5.getParagraphFormat().getBullet().setType(BulletType.Numbered);
    textFrame.getParagraphs().add(paragraph5);

    presentation.save("SetCustomBulletsNumber-slides.pptx", SaveFormat.Pptx);
} finally {
    if (presentation != null) presentation.dispose();
}

Első sor behúzás beállítása bekezdéshez

Használja az IParagraphFormat.setIndent metódust a bekezdés első sorának behúzásának szabályozásához. Ez a metódus csak az első sort mozgatja a bekezdés bal margójához képest. A pozitív érték jobbra tolja az első sort, míg a többi sor a bekezdés törzséhez igazodik.

Használja az IParagraphFormat.setMarginLeft metódust, ha az egész bekezdést szeretné eltolni. Használja az IParagraphFormat.setIndent metódust, ha csak az első sort szeretné eltolni.

A lenti példa több bekezdést hoz létre, és különböző behúzási értékeket alkalmaz, hogy bemutassa, hogyan befolyásolja az első sor behúzása a bekezdés elrendezését.

1. Hozzon létre egy példányt a Presentation osztályból.
2. Érje el a cél diát.
3. Adjon hozzá egy téglalap AutoShape alakzatot a diára.
4. Adjon hozzá egy üres TextFrame alakzathoz, és távolítsa el az alapértelmezett bekezdést.
5. Hozzon létre több bekezdést, és állítson be különböző Indent értékeket számukra.
6. Adja hozzá a bekezdéseket a szövegkerethez.
7. Mentse el a módosított prezentációt.

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape rectangleShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 420, 220);
    rectangleShape.getFillFormat().setFillType(FillType.NoFill);
    rectangleShape.getLineFormat().getFillFormat().setFillType(FillType.Solid);
    rectangleShape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.GRAY);

    ITextFrame textFrame = rectangleShape.addTextFrame("");
    textFrame.getTextFrameFormat().setAutofitType(TextAutofitType.Shape);
    textFrame.getParagraphs().removeAt(0);

    Paragraph firstParagraph = new Paragraph();
    firstParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    firstParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    firstParagraph.setText("No first-line indent. Wrapped lines start at the same position as the first line.");
    firstParagraph.getParagraphFormat().setMarginLeft(20f);
    firstParagraph.getParagraphFormat().setIndent(0f);

    Paragraph secondParagraph = new Paragraph();
    secondParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    secondParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    secondParagraph.setText("First-line indent of 20 points. The first line moves to the right, while wrapped lines remain aligned to the paragraph body.");
    secondParagraph.getParagraphFormat().setMarginLeft(20f);
    secondParagraph.getParagraphFormat().setIndent(20f);

    Paragraph thirdParagraph = new Paragraph();
    thirdParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    thirdParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    thirdParagraph.setText("First-line indent of 40 points. This paragraph shows a larger first-line offset to make the effect easier to see.");
    thirdParagraph.getParagraphFormat().setMarginLeft(20f);
    thirdParagraph.getParagraphFormat().setIndent(40f);

    textFrame.getParagraphs().add(firstParagraph);
    textFrame.getParagraphs().add(secondParagraph);
    textFrame.getParagraphs().add(thirdParagraph);

    presentation.save("paragraph_indent.pptx", SaveFormat.Pptx);
}
finally {
    presentation.dispose();
}

Az eredmény:

Függő behúzás beállítása bekezdéshez

A függő behúzás egy olyan bekezdéselrendezés, amelyben az első sor balra indul a többi sorhoz képest. Az Aspose.Slides-ban ezt a hatást az IParagraphFormat.setIndent metódussal hozhatja létre. Állítsa a behúzást negatív értékre, hogy az első sor balra mozduljon a bekezdés törzséhez képest.

Gyakorlatban az IParagraphFormat.setMarginLeft a bekezdés törzsének bal pozícióját határozza meg, míg az IParagraphFormat.setIndent az első sor pozícióját a marginhoz képest. Függő behúzás létrehozásához állítson be pozitív MarginLeft értéket és negatív Indent értéket.

Ez a formázás hasznos bibliográfiák, hivatkozások, szószedet-bejegyzések és más bekezdések esetén, ahol a sortörés után a soroknak a bekezdés törzsénél kell igazodniuk, nem pedig az első sor első karakterénél.

1. Hozzon létre egy példányt a Presentation osztályból.
2. Érje el a cél diát.
3. Adjon hozzá egy téglalap AutoShape alakzatot a diára.
4. Adjon hozzá egy üres TextFrame alakzathoz, és távolítsa el az alapértelmezett bekezdést.
5. Hozzon létre bekezdéseket, és állítson be minden bekezdéshez egy pozitív MarginLeft értéket.
6. Állítson be egy negatív Indent értéket a függő behúzás hatás létrehozásához.
7. Adja hozzá a bekezdéseket a szövegkerethez.
8. Mentse el a módosított prezentációt.

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IAutoShape rectangleShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 420, 220);
    rectangleShape.getFillFormat().setFillType(FillType.NoFill);
    rectangleShape.getLineFormat().getFillFormat().setFillType(FillType.Solid);
    rectangleShape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.GRAY);

    ITextFrame textFrame = rectangleShape.addTextFrame("");
    textFrame.getTextFrameFormat().setAutofitType(TextAutofitType.Shape);
    textFrame.getParagraphs().removeAt(0);

    Paragraph firstParagraph = new Paragraph();
    firstParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    firstParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    firstParagraph.setText("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.getParagraphFormat().setMarginLeft(40f);
    firstParagraph.getParagraphFormat().setIndent(-20f);

    Paragraph secondParagraph = new Paragraph();
    secondParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    secondParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    secondParagraph.setText("This second example uses a deeper hanging indent so the difference between the first line and the wrapped lines is easier to compare.");
    secondParagraph.getParagraphFormat().setMarginLeft(60f);
    secondParagraph.getParagraphFormat().setIndent(-30f);

    textFrame.getParagraphs().add(firstParagraph);
    textFrame.getParagraphs().add(secondParagraph);

    presentation.save("hanging_indent.pptx", SaveFormat.Pptx);
}
finally {
    presentation.dispose();
}

Az eredmény:

Bekezdés végrehajtási tulajdonságainak kezelése

1. Hozzon létre egy példányt a Presentation osztályból.
2. Szerezze meg a bekezdést tartalmazó dia hivatkozását a pozíciója alapján.
3. Adjon hozzá egy téglalap autoshape alakzatot a diára.
4. Adjon hozzá egy TextFrame alakzatot két bekezdéssel a téglalaphoz.
5. Állítsa be a FontHeight és a betűtípus típusát a bekezdésekhez.
6. Állítsa be a bekezdések End (vég) tulajdonságait.
7. Írja ki a módosított prezentációt PPTX fájlként.

Presentation pres = new Presentation();
try {
    IAutoShape shape = pres.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 10, 10, 200, 250);

    Paragraph para1 = new Paragraph();
    para1.getPortions().add(new Portion("Sample text"));

    Paragraph para2 = new Paragraph();
    para2.getPortions().add(new Portion("Sample text 2"));

    PortionFormat portionFormat = new PortionFormat();
    portionFormat.setFontHeight(48);
    portionFormat.setLatinFont(new FontData("Times New Roman"));
    para2.setEndParagraphPortionFormat(portionFormat);

    shape.getTextFrame().getParagraphs().add(para1);
    shape.getTextFrame().getParagraphs().add(para2);

    pres.save(resourcesOutputPath+"pres.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

HTML szöveg importálása bekezdésekbe

Az Aspose.Slides fejlett támogatást nyújt HTML szöveg bekezdésekbe való importálásához.

1. Hozzon létre egy példányt a Presentation osztályból.
2. A megfelelő diára hivatkozást érje el az indexe alapján.
3. Adjon hozzá egy autoshape alakzatot a diára.
4. Adja hozzá és érje el az autoshape ITextFrame elemet.
5. Távolítsa el az alapértelmezett bekezdést a ITextFrame-ben.
6. Olvassa be a forrás HTML fájlt egy TextReader használatával.
7. Hozza létre az első bekezdést a Paragraph osztály segítségével.
8. Adja hozzá a beolvasott TextReader tartalmát a TextFrame ParagraphCollection gyűjteményéhez.
9. Mentse el a módosított prezentációt.

// Üres prezentáció példány létrehozása
Presentation pres = new Presentation();
try {
    // A prezentáció alapértelmezett első diájának elérése
    ISlide slide = pres.getSlides().get_Item(0);

    // AutoShape hozzáadása a HTML tartalom elhelyezéséhez
    IAutoShape ashape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 10,
            (float)pres.getSlideSize().getSize().getWidth() - 20, (float)pres.getSlideSize().getSize().getHeight() - 10);

    ashape.getFillFormat().setFillType(FillType.NoFill);

    // Szövegkeret hozzáadása az alakzathoz
    ashape.addTextFrame("");

    // A hozzáadott szövegkeret összes bekezdésének törlése
    ashape.getTextFrame().getParagraphs().clear();

    // HTML fájl betöltése stream olvasóval
    TextReader tr = new StreamReader("file.html");

    // HTML stream olvasóból származó szöveg hozzáadása a szövegkerethez
    ashape.getTextFrame().getParagraphs().addFromHtml(tr.readToEnd());

    // Prezentáció mentése
    pres.save("output_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Bekezdés szöveg exportálása HTML-be

Az Aspose.Slides fejlett támogatást nyújt a szövegek (bekezdésekben lévő) HTML-be való exportálásához.

1. Hozzon létre egy példányt a Presentation osztályból, és töltse be a kívánt prezentációt.
2. A megfelelő diára hivatkozást érje el az indexe alapján.
3. Érje el azt az alakzatot, amely a HTML-re exportálandó szöveget tartalmazza.
4. Érje el a shape TextFrame elemét.
5. Hozzon létre egy StreamWriter példányt, és adja hozzá az új HTML fájlt.
6. Adjon meg egy kezdő indexet a StreamWriternek, és exportálja a kívánt bekezdéseket.

// Prezentáció fájl betöltése
Presentation pres = new Presentation("ExportingHTMLText.pptx");
try {
    // A prezentáció alapértelmezett első diájának elérése
    ISlide slide = pres.getSlides().get_Item(0);

    // Kívánt index
    int index = 0;

    // Hozzáadott alakzat elérése
    IAutoShape ashape = (IAutoShape) slide.getShapes().get_Item(index);

    // Kimeneti HTML fájl létrehozása
    OutputStream os = new FileOutputStream("output.html");
    Writer writer = new OutputStreamWriter(os, "UTF-8");

    // Az első bekezdés kinyerése HTML-ként
    // Bekezdések adatainak írása HTML-be a bekezdés kezdő indexének és a másolandó bekezdések számának megadásával
    writer.write(ashape.getTextFrame().getParagraphs().exportToHtml(0, ashape.getTextFrame().getParagraphs().getCount(), null));
    writer.close();
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

Bekezdés mentése képként

Ebben a szakaszban két példát vizsgálunk meg, amelyek bemutatják, hogyan menthet egy szövegbekezdéset, amelyet az IParagraph interfész képvisel, képként. Mindkét példa tartalmazza a bekezdést tartalmazó alakzat képének lekérését a IShape interfész getImage metódusaival, a bekezdés alakzaton belüli határainak kiszámítását, és exportálását bitmap képként. Ezek a módszerek lehetővé teszik a PowerPoint prezentációkból származó szöveg konkrét részeinek kinyerését és különálló képként való mentését, ami különféle helyzetekben hasznos lehet.

Tegyük fel, hogy van egy sample.pptx nevű prezentációs fájlunk egy diával, ahol az első alakzat egy három bekezdést tartalmazó szövegdoboz.

Példa 1

Ebben a példában a második bekezdést képként nyerjük ki. Ehhez kinyerjük az alakzat képét a prezentáció első diájáról, majd kiszámítjuk a második bekezdés határait az alakzat szövegkeretében. A bekezdést ezután egy új bitmap képre rajzoljuk rá, amely PNG formátumban kerül mentésre. Ez a módszer különösen hasznos, ha egy adott bekezdést külön képként szeretné menteni, megőrizve a szöveg pontos méreteit és formázását.

Presentation presentation = new Presentation("sample.pptx");
try {
    IAutoShape firstShape = (IAutoShape) presentation.getSlides().get_Item(0).getShapes().get_Item(0);

    // A alakzat mentése memóriába bitmapként.
    IImage shapeImage = firstShape.getImage();
    ByteArrayOutputStream shapeImageStream = new ByteArrayOutputStream();
    shapeImage.save(shapeImageStream, ImageFormat.Png);
    shapeImage.dispose();

    // Alakzat bitmap létrehozása memóriából.
    InputStream shapeImageInputStream = new ByteArrayInputStream(shapeImageStream.toByteArray());
    BufferedImage shapeBitmap = ImageIO.read(shapeImageInputStream);

    // A második bekezdés határainak kiszámítása.
    IParagraph secondParagraph = firstShape.getTextFrame().getParagraphs().get_Item(1);
    Rectangle2D paragraphRectangle = secondParagraph.getRect();

    // A kimeneti kép koordinátáinak és méretének kiszámítása (minimum méret - 1x1 pixel).
    int imageX = (int) Math.floor(paragraphRectangle.getX());
    int imageY = (int) Math.floor(paragraphRectangle.getY());
    int imageWidth = Math.max(1, (int) Math.ceil(paragraphRectangle.getWidth()));
    int imageHeight = Math.max(1, (int) Math.ceil(paragraphRectangle.getHeight()));

    // Az alakzat bitmap levágása, hogy csak a bekezdés bitmap legyen.
    BufferedImage paragraphBitmap = shapeBitmap.getSubimage(imageX, imageY, imageWidth, imageHeight);

    ImageIO.write(paragraphBitmap, "png", new File("paragraph.png"));
} catch (IOException e) {
} finally {
    if (presentation != null) presentation.dispose();
}

Az eredmény:

Példa 2

Ebben a példában a korábbi megközelítést kibővítjük skálázási tényezők hozzáadásával a bekezdés képéhez. Az alakzatot a prezentációból kibontjuk, és 2-es skálázási tényezővel képként mentjük. Ez magasabb felbontású kimenetet tesz lehetővé a bekezdés exportálásakor. A bekezdés határait ezután a skálát figyelembe véve számítjuk ki. A skálázás különösen hasznos, ha részletesebb képre van szükség, például magas minőségű nyomtatott anyagokhoz.

float imageScaleX = 2f;
float imageScaleY = imageScaleX;

Presentation presentation = new Presentation("sample.pptx");
try {
    IAutoShape firstShape = (IAutoShape) presentation.getSlides().get_Item(0).getShapes().get_Item(0);

    // Az alakzat mentése memóriába bitmapként skálázással.
    IImage shapeImage = firstShape.getImage(ShapeThumbnailBounds.Shape, imageScaleX, imageScaleY);
    ByteArrayOutputStream shapeImageStream = new ByteArrayOutputStream();
    shapeImage.save(shapeImageStream, ImageFormat.Png);
    shapeImage.dispose();

    // Alakzat bitmap létrehozása memóriából.
    InputStream shapeImageInputStream = new ByteArrayInputStream(shapeImageStream.toByteArray());
    BufferedImage shapeBitmap = ImageIO.read(shapeImageInputStream);

    // A második bekezdés határainak kiszámítása.
    IParagraph secondParagraph = firstShape.getTextFrame().getParagraphs().get_Item(1);
    Rectangle2D paragraphRectangle = secondParagraph.getRect();
    paragraphRectangle.setRect(
            paragraphRectangle.getX() * imageScaleX,
            paragraphRectangle.getY() * imageScaleY,
            paragraphRectangle.getWidth() * imageScaleX,
            paragraphRectangle.getHeight() * imageScaleY
    );

    // A kimeneti kép koordinátáinak és méretének kiszámítása (minimum méret - 1x1 pixel).
    int imageX = (int) Math.floor(paragraphRectangle.getX());
    int imageY = (int) Math.floor(paragraphRectangle.getY());
    int imageWidth = Math.max(1, (int) Math.ceil(paragraphRectangle.getWidth()));
    int imageHeight = Math.max(1, (int) Math.ceil(paragraphRectangle.getHeight()));

    // Az alakzat bitmap levágása, hogy csak a bekezdés bitmap legyen.
    BufferedImage paragraphBitmap = shapeBitmap.getSubimage(imageX, imageY, imageWidth, imageHeight);

    ImageIO.write(paragraphBitmap, "png", new File("paragraph.png"));
} catch (IOException e) {
} finally {
    if (presentation != null) presentation.dispose();
}

FAQ

Teljesen letilthatom a sortörést egy szövegkereten belül?

Igen. Használja a szövegkeret sortörés beállítását (setWrapText), hogy kikapcsolja a sortörést, így a sorok nem törnek meg a keret szélén.

Hogyan kaphatom meg egy adott bekezdés pontos dián lévő határait?

Le tudja kérni a bekezdés (és akár egyetlen rész) körülhatároló téglalapját, hogy megtudja annak pontos pozícióját és méretét a dián.

Hol szabályozható a bekezdés igazítása (balra/jobbra/középre/széthúzott)?

Az Alignment bekezdés szintű beállítás a ParagraphFormat‑ben; a teljes bekezdésre alkalmazódik, függetlenül az egyes részek formázásától.

Beállíthatok helyesírás-nyelvet csak a bekezdés egy részére (például egy szóra)?

Igen. A nyelvet a rész szintjén állítják be (PortionFormat.setLanguageId), így több nyelv is létezhet egy bekezdésen belül.