PowerPoint szövegbekezdések kezelése Androidon

Áttekintés

Az Aspose.Slides for Android via Java a szöveget szövegdobozok, bekezdések és részek hierarchiájaként ábrázolja:

  • ITextFrame a szöveg tárolója egy alakzatban, és hozzáférést biztosít a bekezdések gyűjteményéhez.
  • IParagraph egy bekezdést képvisel egy szövegdobozban, és hozzáférést biztosít a részeihez és a bekezdés‑szintű formázáshoz.
  • IPortion egy szövegrészt képvisel egy bekezdésen belül. Minden résznek saját szövege és karakter‑szintű formázása lehet.

Ezért egy bekezdés tartalmazhat különböző betűtípusú, színű, méretű és egyéb formázású szöveget több rész használatával.

Bekezdések létrehozása és formázása

Bekezdések létrehozása egy alakzat szövegdobozában, és a részek használata az egyes szöveg‑futások formázásához. Ez a szakasz bemutatja, hogyan kombinálhatók több rész egy bekezdésen belül, és hogyan alkalmazhatók különböző színek, betűméretek és stílusok.

Bekezdések létrehozása több résszel

A következő Android via Java példa három bekezdést hoz létre, mindegyik három szövegrészt tartalmaz a IParagraph.getPortions által visszaadott gyűjteményben. Újra felhasználja az alapértelmezett bekezdést és annak üres részét, majd hozzáadja a maradék bekezdéseket és részeket. A formázás a IPortion.getPortionFormat segítségével kerül alkalmazásra: az első rész minden bekezdésben piros, félkövér és 15 pont; a második kék, dőlt és 18 pont. A harmadik rész megőrzi az alapértelmezett formázását:

import com.aspose.slides.*;
import android.graphics.Color;

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

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 150, 300, 150);
    ITextFrame textFrame = shape.getTextFrame();

    IParagraph firstParagraph = textFrame.getParagraphs().get_Item(0);
    firstParagraph.getPortions().add(new Portion());
    firstParagraph.getPortions().add(new Portion());

    IParagraph secondParagraph = new Paragraph();
    secondParagraph.getPortions().add(new Portion());
    secondParagraph.getPortions().add(new Portion());
    secondParagraph.getPortions().add(new Portion());
    textFrame.getParagraphs().add(secondParagraph);

    IParagraph thirdParagraph = new Paragraph();
    thirdParagraph.getPortions().add(new Portion());
    thirdParagraph.getPortions().add(new Portion());
    thirdParagraph.getPortions().add(new Portion());
    textFrame.getParagraphs().add(thirdParagraph);

    int paragraphCount = textFrame.getParagraphs().getCount();
    for (int paragraphIndex = 0; paragraphIndex < paragraphCount; paragraphIndex++) {
        IParagraph paragraph = textFrame.getParagraphs().get_Item(paragraphIndex);
        int portionCount = paragraph.getPortions().getCount();
        for (int portionIndex = 0; portionIndex < portionCount; portionIndex++) {
            IPortion portion = paragraph.getPortions().get_Item(portionIndex);
            portion.setText("Portion " + (paragraphIndex + 1) + "." + (portionIndex + 1));

            if (portionIndex == 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 (portionIndex == 1) {
                portion.getPortionFormat().getFillFormat().setFillType(FillType.Solid);
                portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE);
                portion.getPortionFormat().setFontItalic(NullableBool.True);
                portion.getPortionFormat().setFontHeight(18);
            }
        }
    }

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

Pontozott és számozott listák létrehozása

Rendszerezze a bekezdés‑szöveget listákká szimbólumokkal, számokkal vagy egyedi képekkel. Ebben a részben a pontozás formázását, a többszintű listákat és az egyedi kezdőszámokat mutatjuk be.

Pontozott vagy számozott lista létrehozása

A pontok és a számozás megkönnyítik a kapcsolódó elemek áttekintését. Az Aspose.Slides‑ben a lista beállításait az IBulletFormat határozza meg.

Ez az Android via Java példa egy szimbólum‑pontot és egy számozott elemet ad ugyanahhoz a szövegdobozhoz. Az IBulletFormat.setType választja ki a pont típusát, míg az IBulletFormat.setChar adja meg a szimbólumot, és az IBulletFormat.setNumberedBulletStyle választja ki a számozási stílust. Mindkét elem fekete pontot használ, 100 % magassággal és 25 pont bekezdés‑behúzással:

import com.aspose.slides.*;
import android.graphics.Color;

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

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);
    ITextFrame textFrame = shape.getTextFrame();
    textFrame.getParagraphs().clear();

    Paragraph symbolParagraph = new Paragraph();
    symbolParagraph.setText("Welcome to Aspose.Slides");
    symbolParagraph.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    symbolParagraph.getParagraphFormat().getBullet().setChar((char) 0x2022);
    symbolParagraph.getParagraphFormat().setIndent(25);
    symbolParagraph.getParagraphFormat().getBullet().getColor().setColorType(ColorType.RGB);
    symbolParagraph.getParagraphFormat().getBullet().getColor().setColor(Color.BLACK);
    symbolParagraph.getParagraphFormat().getBullet().setBulletHardColor(NullableBool.True);
    symbolParagraph.getParagraphFormat().getBullet().setHeight(100);
    textFrame.getParagraphs().add(symbolParagraph);

    Paragraph numberedParagraph = new Paragraph();
    numberedParagraph.setText("This is a numbered item");
    numberedParagraph.getParagraphFormat().getBullet().setType(BulletType.Numbered);
    numberedParagraph.getParagraphFormat().getBullet().setNumberedBulletStyle(NumberedBulletStyle.BulletCircleNumWDBlackPlain);
    numberedParagraph.getParagraphFormat().setIndent(25);
    numberedParagraph.getParagraphFormat().getBullet().getColor().setColorType(ColorType.RGB);
    numberedParagraph.getParagraphFormat().getBullet().getColor().setColor(Color.BLACK);
    numberedParagraph.getParagraphFormat().getBullet().setBulletHardColor(NullableBool.True);
    numberedParagraph.getParagraphFormat().getBullet().setHeight(100);
    textFrame.getParagraphs().add(numberedParagraph);

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

Képpontok használata

A képpontok lehetővé teszik egy egyedi kép használatát szimbólum vagy szám helyett.

Ez az Android via Java példa egy képet ad a prezentáció képgyűjteményéhez IPPImage‑ként, és bekezdés‑pontként használja. Az IBulletFormat.setType hívásával képpontot állít be, és a képet az IBulletFormat.getPicture adja meg. Az IBulletFormat.setHeight 100 % értéke a pont méretét a bekezdés‑szöveghez viszonyítva állítja be:

import com.aspose.slides.*;

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

    IImage bulletImage = Images.fromFile("bullets.png");
    IPPImage presentationImage;
    try {
        presentationImage = presentation.getImages().addImage(bulletImage);
    } finally {
        bulletImage.dispose();
    }

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);
    ITextFrame textFrame = shape.getTextFrame();
    textFrame.getParagraphs().clear();

    Paragraph paragraph = new Paragraph();
    paragraph.setText("Welcome to Aspose.Slides");
    paragraph.getParagraphFormat().getBullet().setType(BulletType.Picture);
    paragraph.getParagraphFormat().getBullet().getPicture().setImage(presentationImage);
    paragraph.getParagraphFormat().getBullet().setHeight(100);
    textFrame.getParagraphs().add(paragraph);

    presentation.save("picture_bullet.pptx", SaveFormat.Pptx);
    presentation.save("picture_bullet.ppt", SaveFormat.Ppt);
} finally {
    presentation.dispose();
}

Többszintű lista létrehozása

Az IParagraphFormat.setDepth beállításával helyezhetjük a bekezdéseket a lista különböző szintjeire. A legfelső szint mélysége 0.

Ez az Android via Java példa az IParagraphFormat.setDepth értékeket 0‑tól 3‑ig állítja négy bekezdéshez, egy hierarchiát hozva létre egy szövegdobozban. Minden bekezdés szimbólum‑pontot használ, az IBulletFormat.setChar váltakozva kör alakú pont és kötőjel között a szomszédos szintek megkülönböztetéséhez:

import com.aspose.slides.*;
import android.graphics.Color;

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

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);
    ITextFrame textFrame = shape.getTextFrame();
    textFrame.getParagraphs().clear();

    IParagraph firstParagraph = new Paragraph();
    firstParagraph.setText("Content");
    firstParagraph.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    firstParagraph.getParagraphFormat().getBullet().setChar((char) 0x2022);
    firstParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    firstParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    firstParagraph.getParagraphFormat().setDepth((short) 0);

    IParagraph secondParagraph = new Paragraph();
    secondParagraph.setText("Second level");
    secondParagraph.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    secondParagraph.getParagraphFormat().getBullet().setChar('-');
    secondParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    secondParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    secondParagraph.getParagraphFormat().setDepth((short) 1);

    IParagraph thirdParagraph = new Paragraph();
    thirdParagraph.setText("Third level");
    thirdParagraph.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    thirdParagraph.getParagraphFormat().getBullet().setChar((char) 0x2022);
    thirdParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    thirdParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    thirdParagraph.getParagraphFormat().setDepth((short) 2);

    IParagraph fourthParagraph = new Paragraph();
    fourthParagraph.setText("Fourth level");
    fourthParagraph.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    fourthParagraph.getParagraphFormat().getBullet().setChar('-');
    fourthParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    fourthParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    fourthParagraph.getParagraphFormat().setDepth((short) 3);

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

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

Számozott listaelemek egyedi kezdőértékkel

Az IBulletFormat.setNumberedBulletStartWith használatával állítható be a számozott bekezdés kezdeti száma.

Ez az Android via Java példa az IBulletFormat.setType segítségével számozást állít be három bekezdéshez, és a IBulletFormat.setNumberedBulletStartWith értékek 2, 3 és 7. A kezdőérték minden bekezdésnél külön konfigurálható, így a megjelenített számok kiugorhatnak:

import com.aspose.slides.*;

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

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);
    ITextFrame textFrame = shape.getTextFrame();
    textFrame.getParagraphs().clear();

    Paragraph firstParagraph = new Paragraph();
    firstParagraph.setText("Start at 2");
    firstParagraph.getParagraphFormat().getBullet().setType(BulletType.Numbered);
    firstParagraph.getParagraphFormat().getBullet().setNumberedBulletStartWith((short) 2);
    textFrame.getParagraphs().add(firstParagraph);

    Paragraph secondParagraph = new Paragraph();
    secondParagraph.setText("Start at 3");
    secondParagraph.getParagraphFormat().getBullet().setType(BulletType.Numbered);
    secondParagraph.getParagraphFormat().getBullet().setNumberedBulletStartWith((short) 3);
    textFrame.getParagraphs().add(secondParagraph);

    Paragraph thirdParagraph = new Paragraph();
    thirdParagraph.setText("Start at 7");
    thirdParagraph.getParagraphFormat().getBullet().setType(BulletType.Numbered);
    thirdParagraph.getParagraphFormat().getBullet().setNumberedBulletStartWith((short) 7);
    textFrame.getParagraphs().add(thirdParagraph);

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

Bekezdéselrendezés és befejező tulajdonságok szabályozása

Állítsa be a bekezdés margóit és behúzásait a első sor és a tördeltt sorok pozíciójának szabályozásához. A bekezdés befejező jelét is formázhatja a látható szövegrésszel külön.

Első sor behúzásának beállítása

Az IParagraphFormat.setIndent metódussal szabályozhatja egy bekezdés első sorának behúzását. Ez a beállítás csak az első sort mozdítja el a bekezdés bal margójához képest. A pozitív érték jobbra tolja az első sort, míg a további sorok a bekezdéstörzshez igazodnak.

Használja az IParagraphFormat.setMarginLeft metódust, ha a teljes bekezdést szeretné elmozgatni. Használja az IParagraphFormat.setIndent metódust, ha csak az első sort szeretné elmozgatni.

Az alábbi példa három bekezdésnek ugyanazt a IParagraphFormat.setMarginLeft 20 pont és a IParagraphFormat.setIndent értékeket 0, 20 és 40 pont adja. Az első sorok fokozatosan nagyobb eltolással indulnak, míg a tördeltt sorok azonos bal margót tartanak meg:

import com.aspose.slides.*;
import android.graphics.Color;

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

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

    ITextFrame textFrame = shape.getTextFrame();
    textFrame.getTextFrameFormat().setAutofitType(TextAutofitType.Shape);
    textFrame.getParagraphs().clear();

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

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

    Paragraph thirdParagraph = new Paragraph();
    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().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    thirdParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    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:

A bekezdések első sorának behúzása

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

A függő behúzás olyan bekezdéselrendezés, amelyben az első sor a többi sor bal oldalán kezdődik. Az Aspose.Slides‑ben ezt a hatást az IParagraphFormat.setIndent tulajdonsággal hozhatja létre. Állítsa az Indent‑et negatív értékre, hogy az első sor balra mozduljon a bekezdéstörzshöz képest.

Gyakorlatban az IParagraphFormat.setMarginLeft határozza meg a bekezdéstörzs bal pozícióját, az IParagraphFormat.setIndent pedig az első sor pozícióját ahhoz a margóhoz 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ákhoz, hivatkozásokhoz, szószedet-bejegyzésekhez és más bekezdésekhez, ahol a tördeltt soroknak a bekezdéstörzs alatt kell igazodniuk, nem pedig az első sor első karaktere alatt.

Az alábbi Android via Java példa az IParagraphFormat.setMarginLeft 40 pont és 60 pont értékeit párosítja az IParagraphFormat.setIndent –20 pont és –30 pont értékeivel. Minden bekezdésben az első sor a tördeltt sorok bal oldalán kezdődik; a második bekezdés mélyebb függő behúzást tartalmaz:

import com.aspose.slides.*;
import android.graphics.Color;

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

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

    ITextFrame textFrame = shape.getTextFrame();
    textFrame.getTextFrameFormat().setAutofitType(TextAutofitType.Shape);
    textFrame.getParagraphs().clear();

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

    Paragraph secondParagraph = new Paragraph();
    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().getDefaultPortionFormat().getFillFormat().setFillType(FillType.Solid);
    secondParagraph.getParagraphFormat().getDefaultPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
    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:

A bekezdések függő behúzása

Befejező bekezdés‑rész tulajdonságainak beállítása

Az IParagraph.setEndParagraphPortionFormat metódus a bekezdés befejező jelének formázását szabályozza. Az alábbi példa egy PortionFormat objektumot hoz létre, ahol az IBasePortionFormat.setFontHeight 48 pont, az IBasePortionFormat.setLatinFont pedig Times New Roman. Ezt a formátumot a második bekezdés befejező jelére alkalmazza, a látható szövegrésszek változatlanul hagyva:

import com.aspose.slides.*;

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

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 10, 200, 250);
    ITextFrame textFrame = shape.getTextFrame();
    textFrame.getParagraphs().clear();

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

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

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

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

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

Megjelenített sorok számlálása

Az automatikus tördelést és a sorvégi írásjelek kezelését befolyásoló bekezdés‑szabályokért lásd a Control Line Breaking és a Control Hanging Punctuation témákat.

A IParagraph.getLinesCount metódussal számlálhatók a bekezdés által a szöveg elrendezése után elfoglalt sorok, beleértve az automatikus tördelést. Ez hasznos a szöveg‑hossz és elrendezés ellenőrzésénél prezentációs sablonokban.

Egy bekezdés egy elem a ITextFrame.getParagraphs gyűjteményben, és több megjelenített sort is elfoglalhat. Egy explicit sortörés egy bekezdésen belül új sort kényszerít anélkül, hogy új bekezdést hozna létre. Az automatikus tördelés a rendelkezésre álló szélesség alapján hoz létre sorokat, anélkül, hogy explicit sortöréseket illesztene a szövegbe. Így a bekezdések vagy sortörés‑karakterek számolása nem adja meg a megjelenített sorok számát.

Az alábbi példa egy szöveg‑alakzatot hoz létre, megszámolja a sorait, szűkíti az alakzatot, majd rövidebb szövegre cseréli a tartalmat. A példa a ITextFrameFormat.setWrapText segítségével engedélyezi a tördelést, és a ITextFrameFormat.setAutofitType segítségével letiltja az automatikus illesztést, hogy az alakzat szélessége a tördelést szabályozza anélkül, hogy automatikusan zsugorítaná a szöveget vagy az alakzatot. Minden mérés a IParagraph.getLinesCount metódust használja. Az alakzat méretei pontban vannak megadva. Végül a példa egy újabb bekezdést ad hozzá, és összeadja a sorok számát a szövegdobozban.

import com.aspose.slides.*;

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

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 400, 200);
    ITextFrame textFrame = shape.getTextFrame();
    textFrame.getTextFrameFormat().setWrapText(NullableBool.True);
    textFrame.getTextFrameFormat().setAutofitType(TextAutofitType.None);

    IParagraph paragraph = textFrame.getParagraphs().get_Item(0);
    paragraph.getParagraphFormat().getDefaultPortionFormat().setFontHeight(20);
    paragraph.setText("This text demonstrates how automatic wrapping changes the number of rendered lines.");
    System.out.println("Original width: " + paragraph.getLinesCount());

    shape.setWidth(150);
    System.out.println("Narrower shape: " + paragraph.getLinesCount());

    paragraph.setText("Short text.");
    System.out.println("Shorter text: " + paragraph.getLinesCount());

    Paragraph secondParagraph = new Paragraph();
    secondParagraph.setText("Another paragraph.");
    secondParagraph.getParagraphFormat().getDefaultPortionFormat().setFontHeight(20);
    textFrame.getParagraphs().add(secondParagraph);

    int totalLineCount = 0;
    for (IParagraph currentParagraph : textFrame.getParagraphs()) {
        totalLineCount += currentParagraph.getLinesCount();
    }
    System.out.println("Total lines in the text frame: " + totalLineCount);
} finally {
    presentation.dispose();
}

Ezzel a szöveggel és ezekkel a méretekkel a forma szűkítése növeli a sorok számát, míg a szöveg rövid karakterláncra cserélése csökkenti azt. A pontos számok a betűtípus‑elérhetőségtől, helyettesítéstől, betűmérettől, margóktól, behúzástól, tördeléstől és az automatikus illesztés beállításaitól függnek. A célkörnyezetben használt betűtípusokat és elrendezési beállításokat használja a sablon ellenőrzésekor.

A sorok száma önmagában nem határozza meg, hogy a szöveg kilépi-e a tárolóját. A rendelkezésre álló magasság, sormagasság, bekezdés‑ és sorköz, valamint az automatikus illesztés viselkedése is számít; még egyetlen sor is meghaladhatja a rendelkezésre álló szélességet, ha a tördelés ki van kapcsolva.

Bekezdés‑tartalom importálása és exportálása

Használja a HTML‑t a szöveg prezentációba átviteléhez vagy a meglévő bekezdések exportálásához külső felhasználáshoz. Ebben a részben bemutatjuk, hogyan lehet egyedi bekezdéseket képekké renderelni, beleértve a táblázat‑cellákban lévő bekezdéseket is.

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

A ParagraphCollection.addFromHtml segítségével HTML‑jelölést konvertálhat bekezdésekké és részekké egy szövegdobozban.

Ez az Android via Java példa egy fájlból olvas HTML‑t, és átadja a jelölést a ParagraphCollection.addFromHtml metódusnak. Törli a szövegdoboz alapértelmezett bekezdését, így a keret csak a importált tartalmat tartalmazza. A téglalap alakzat 10 pont margót hagy a dia minden oldalán:

import com.aspose.slides.*;
import java.io.IOException;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Paths;

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

    float shapeWidth = (float) presentation.getSlideSize().getSize().getWidth() - 20;
    float shapeHeight = (float) presentation.getSlideSize().getSize().getHeight() - 20;
    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 10, shapeWidth, shapeHeight);
    shape.getFillFormat().setFillType(FillType.NoFill);
    shape.getTextFrame().getParagraphs().clear();

    try {
        byte[] htmlBytes = Files.readAllBytes(Paths.get("file.html"));
        String html = new String(htmlBytes, StandardCharsets.UTF_8);
        shape.getTextFrame().getParagraphs().addFromHtml(html);
        presentation.save("html_text.pptx", SaveFormat.Pptx);
    } catch (IOException exception) {
        System.out.println("The HTML file could not be read: " + exception.getMessage());
    }
} finally {
    presentation.dispose();
}

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

A ParagraphCollection.exportToHtml segítségével egy kiválasztott bekezdéstartomány exportálható HTML‑ként. Ha a prezentáció szövegét egy weboldalon szeretné újrahasználni, megőrizheti a helyi kiemeléseket anélkül, hogy a prezentáció betűtípusát, méretét vagy a szövegdoboz stílusát átvinné. A TextToHtmlConversionOptions.setTextInheritanceLimit beállítással szabályozhatja, hogy a exportáló milyen mélységig követi a formázási öröklődést.

Töltse le a mintaprezentációt, és helyezze az alkalmazás munkakönyvtárába. Az első dia egy szöveg‑alakzatot tartalmaz a „Inherited text; explicit red 18pt” szöveggel. A bemenet szándékosan több formázási szintet használ:

  • A prezentáció alapértelmezett szövegstílusa Calibri‑t és 28 pt méretet biztosít.
  • A szövegdoboz első szintű szövegstílusa kék szöveget és dőlt betűt biztosít.
  • A bekezdés explicit módon félkövér szöveget állít be.
  • A második rész, „explicit red 18pt”, explicit módon piros szöveget és 18 pt méretet állít be.

Az alábbi teljes példa háromszor exportálja ugyanazokat a bekezdéseket. A TextToHtmlConversionOptions objektumot átadja az exportálási metódusnak, és az eredményt külön‑külön UTF‑8 HTML fájlként írja:

import com.aspose.slides.*;
import java.io.IOException;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Paths;

Presentation presentation = new Presentation("text-inheritance.pptx");
try {
    IShape shape = presentation.getSlides().get_Item(0).getShapes().get_Item(0);

    if (shape instanceof IAutoShape) {
        IAutoShape textShape = (IAutoShape) shape;
        ITextFrame textFrame = textShape.getTextFrame();
        if (textFrame != null) {
            IParagraphCollection paragraphs = textFrame.getParagraphs();
            
            int[] modes = { TextInheritanceLimit.All, TextInheritanceLimit.TextBox, TextInheritanceLimit.ParagraphOnly };
            String[] fileNames = { "All.html", "TextBox.html", "ParagraphOnly.html" };

            for (int i = 0; i < modes.length; i++) {
                TextToHtmlConversionOptions options = new TextToHtmlConversionOptions();
                options.setTextInheritanceLimit(modes[i]);

                String html = paragraphs.exportToHtml(0, paragraphs.getCount(), options);
                byte[] htmlBytes = html.getBytes(StandardCharsets.UTF_8);
                try {
                    Files.write(Paths.get(fileNames[i]), htmlBytes);
                } catch (IOException exception) {
                    System.out.println("The HTML file could not be written: " + exception.getMessage());
                }
            }
        } else {
            System.out.println("The first shape does not contain a text frame.");
        }
    } else {
        System.out.println("The first shape is not a text shape.");
    }
} finally {
    presentation.dispose();
}

A generált HTML a következő CSS‑t tartalmazza az első részhez, „Inherited text; “. A táblázat a releváns deklarációkat sorolja; a többi generált tulajdonság a tisztaság kedvéért ki van hagyva.

Output Relevant CSS for the first portion Appearance
All.html font-family:'Calibri'; font-size:28pt; color:#0000ff; font-style:italic; font-weight:bold Kék, félkövér, dőlt szöveg 28 pt‑ben Calibri‑ben, ha az a betűtípus elérhető.
TextBox.html color:#0000ff; font-style:italic; font-weight:bold Kék, félkövér, dőlt szöveg; a környező oldal vagy böngésző adja a betűtípust és a méretet.
ParagraphOnly.html font-weight:bold Félkövér szöveg; a környező oldal vagy böngésző adja a betűtípust, méretet, színt és a dőlt stílust.

A második rész minden három kimenetben megtartja a color:#ff0000, font-size:18pt és font-weight:bold értékeket. Az All és a TextBox esetén megmarad a dőlt formázás, de a ParagraphOnly esetében nem. Az öröklődés korlátozása ezért nem távolítja el a bekezdéshez vagy részhez explicit módon rendelt formázást.

Nyissa meg a fájlokat ugyanabban a böngészőben a összehasonlításhoz. A két korlátozott módban a kihagyott CSS‑tulajdonságok a céloldal stílusai vagy a böngésző alapértelmezései alapján kerülnek feloldásra, így a megjelenés attól függ, hogy hol használják a HTML‑t.

HTML‑vágólap‑töredék generálása

A TextToHtmlConversionOptions.setAddClipboardFragmentHeader beállítással választható a IParagraphCollection.exportToHtml kimenete. false esetén a metódus szokványos HTML‑t ad vissza. true esetén a visszatérő karakterlánc egy Windows vágólap‑fejlécet tartalmaz. A StartHTML és EndHTML mezők a HTML UTF‑8 bájteltolását adják meg, míg a StartFragment és EndFragment a beillesztendő tartalmat jelölik.

Ez a példa két formázott bekezdést exportál szokványos HTML‑ként (html) és HTML‑vágólap‑töredékként (clipboardHtml). Az olyan alkalmazások, amelyek a Windows HTML‑vágólap‑formátumot támogatják, közvetlenül felhasználhatják a töredéket. Ha a vágólap‑API nyers bájtokat vár, kódolja a töredéket UTF‑8‑ban BOM‑nélkül.

import com.aspose.slides.*;

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

    IAutoShape shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 0, 0, 400, 100);
    IParagraphCollection paragraphs = shape.getTextFrame().getParagraphs();
    paragraphs.clear();
    paragraphs.addFromHtml("<p>Status: <b>Ready</b></p><p><i>Next steps</i></p>");

    TextToHtmlConversionOptions options = new TextToHtmlConversionOptions();
    options.setAddClipboardFragmentHeader(false);
    String html = paragraphs.exportToHtml(0, paragraphs.getCount(), options);

    options.setAddClipboardFragmentHeader(true);
    String clipboardHtml = paragraphs.exportToHtml(0, paragraphs.getCount(), options);
} finally {
    presentation.dispose();
}

Bekezdés renderelése képként

Az IParagraph.getImage közvetlenül rendereli az egyes bekezdéseket, és egy IImage objektumot ad vissza. Az eredményt a IImage.save metódussal mentheti fájlba vagy folyamathoz. Nem szükséges a tartalmazó alakzatot renderelni vagy a bitmapet kézzel levágni.

Az IParagraph.getImage null‑t adhat vissza, ha a bekezdés nem található a szülőgyűjteményben, nincs érvényes renderelési határa, vagy nem renderelhető. Ellenőrizze az eredményt a mentés előtt, és a használat után szabadítsa fel a visszakapott képet.

Bekezdés renderelése alapméretezésben

A példa egy olyan prezentációt használ, amelynek egyetlen diája van, és az első alakzata egy három bekezdést tartalmazó szövegmező.

A három bekezdést tartalmazó szövegmező

Az alábbi példa a második bekezdést (index 1) választja ki, és a IParagraph.getImage metódust skálaparaméterek nélkül hívja. Ellenőrizze, hogy az alakzat tartalmazza a szükséges bekezdést, és a renderelés képet ad vissza, mielőtt a IImage.save metódussal PNG‑ként mentené. A finally blokk a használat után felszabadítja a képet.

import com.aspose.slides.*;

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

    if (shape instanceof IAutoShape) {
        IAutoShape textShape = (IAutoShape) shape;
        ITextFrame textFrame = textShape.getTextFrame();
        if (textFrame != null && textFrame.getParagraphs().getCount() > 1) {
            IParagraph paragraph = textFrame.getParagraphs().get_Item(1);
            IImage paragraphImage = paragraph.getImage();

            if (paragraphImage != null) {
                try {
                    paragraphImage.save("paragraph.png", ImageFormat.Png);
                } finally {
                    paragraphImage.dispose();
                }
            } else {
                System.out.println("The paragraph could not be rendered.");
            }
        } else {
            System.out.println("The expected paragraph was not found.");
        }
    } else {
        System.out.println("The first shape is not a text shape.");
    }
} finally {
    presentation.dispose();
}

Az eredmény:

A bekezdés képe

Bekezdés renderelése táblázat‑cella‑méretarányos skálázással

Használja az IParagraph.getImage túlterhelést, amely float scaleX és float scaleY paramétereket fogad a vízszintes és függőleges skálafaktorok beállításához. Az alábbi példa táblázatot hoz létre, és a bekezdést az első cellájában a alapméret kétszeres szélességén és magasságán rendereli, majd PNG‑ként menti az eredményt.

import com.aspose.slides.*;

float scaleX = 2f;
float scaleY = 2f;

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

    ITable table = slide.getShapes().addTable(50, 50, new double[] { 300 }, new double[] { 80 });
    IParagraph paragraph = table.get_Item(0, 0).getTextFrame().getParagraphs().get_Item(0);
    paragraph.setText("Text in a table cell");

    IImage paragraphImage = paragraph.getImage(scaleX, scaleY);
    if (paragraphImage != null) {
        try {
            paragraphImage.save("table_paragraph.png", ImageFormat.Png);
        } finally {
            paragraphImage.dispose();
        }
    } else {
        System.out.println("The paragraph could not be rendered.");
    }
} finally {
    presentation.dispose();
}

Az 1‑es skálafaktor az adott tengelyen az alappixelméretet tartja meg. Például a 2‑es érték mindkét tényezőnél egy olyan képet eredményez, amelynek szélessége és magassága nagyjából kétszerese az alapméretnek, így a pixel szám négyszeres lesz. A nagyobb tényezők általában élesebb szöveget adnak nagyítás vagy magas felbontású kimenet esetén, de a memóriahasználatot és a fájlméretet is növelik. Az 1‑nél kisebb tényezők kisebb, kevésbé részletgazdag képeket eredményeznek. Egyenlő tényezők megőrzik a bekezdés méretarányát; a különböző vízszintes és függőleges tényezők önállóan nyújtják a kimenetet.

Egész alakzat renderelése az IShape.getImage segítségével akkor hasznos, ha a kimenetnek tartalmaznia kell az alakzat kitöltését, szegélyét vagy egyéb vizuális kontextusát. Egy csak bekezdés‑képhez használja az IParagraph.getImage metódust.

GYIK

Teljesen letiltható a sorok tördelése egy szövegdobozban?

Igen. Az ITextFrameFormat.setWrapText beállításával letiltható a tördelés, így a sorok nem törnek meg a szövegdoboz szélén.

Hogyan kaphatom meg egy adott bekezdés pontos helyi határait a dián?

Használja az IParagraph.getRect metódust a bekezdés határoló téglalapjának lekéréséhez. Az IPortion.getRect egy egyedi rész határait adja vissza.

Hol szabályozható a bekezdés igazítása (balra, jobbra, középre vagy sorkizárt)?

Az IParagraphFormat.setAlignment bekezdés‑szintű beállítás, amely a teljes bekezdésre vonatkozik, függetlenül az egyes részek formázásától.

A különböző betűméretű részek függőleges igazításához lásd a Align Fonts Within a Line szakaszt.

Beállítható a nyelvi ellenőrzés csak a bekezdés egy részére?

Igen. Az IBasePortionFormat.setLanguageId beállításával egyes részekhez meghatározható a nyelv, így egy bekezdés több nyelvet is tartalmazhat.