Gestire i paragrafi di testo di PowerPoint su Android

Introduzione

Aspose.Slides fornisce tutte le interfacce e le classi necessarie per lavorare con testi, paragrafi e porzioni di PowerPoint in Java.

  • Aspose.Slides fornisce l’interfaccia ITextFrame per consentire di aggiungere oggetti che rappresentano un paragrafo. Un oggetto ITextFame può contenere uno o più paragrafi (ogni paragrafo viene creato mediante un ritorno a capo).
  • Aspose.Slides fornisce l’interfaccia IParagraph per consentire di aggiungere oggetti che rappresentano porzioni. Un oggetto IParagraph può contenere una o più porzioni (collezione di oggetti iPortions).
  • Aspose.Slides fornisce l’interfaccia IPortion per consentire di aggiungere oggetti che rappresentano testi e le loro proprietà di formattazione.

Un oggetto IParagraph è in grado di gestire testi con diverse proprietà di formattazione tramite i relativi oggetti IPortion sottostanti.

Aggiungere più paragrafi contenenti più porzioni di testo

Questi passaggi mostrano come aggiungere un frame di testo contenente 3 paragrafi, ciascuno dei quali contiene 3 porzioni:

  1. Crea un’istanza della classe Presentation.
  2. Accedi al riferimento della diapositiva desiderata tramite il suo indice.
  3. Aggiungi un rettangolo IAutoShape alla diapositiva.
  4. Ottieni l’ITextFrame associato al IAutoShape.
  5. Crea due oggetti IParagraph e aggiungili alla raccolta IParagraphs del ITextFrame.
  6. Crea tre oggetti IPortion per ogni nuovo IParagraph (due oggetti Portion per il paragrafo predefinito) e aggiungi ciascun oggetto IPortion alla raccolta IPortion di ciascun IParagraph.
  7. Imposta del testo per ogni porzione.
  8. Applica le funzionalità di formattazione desiderate a ogni porzione usando le proprietà di formattazione esposte dall’oggetto IPortion.
  9. Salva la presentazione modificata.
// Istanziare una classe Presentation che rappresenta un file PPTX
Presentation pres = new Presentation();
try {
    // Accesso alla prima diapositiva
    ISlide slide = pres.getSlides().get_Item(0);

    // Aggiungere un AutoShape di tipo Rettangolo
    IAutoShape ashp = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 150, 300, 150);

    // Accedere al TextFrame dell'AutoShape
    ITextFrame tf = ashp.getTextFrame();

    // Creare paragrafi e porzioni con diversi formati di testo
    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);
            }
        }
    }

    //Scrivi PPTX su disco
    pres.save("multiParaPort_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Gestire i punti elenco del paragrafo

Gli elenchi puntati ti aiutano a organizzare e presentare le informazioni in modo rapido ed efficiente. I paragrafi puntati sono sempre più facili da leggere e comprendere.

  1. Crea un’istanza della classe Presentation.
  2. Accedi al riferimento della diapositiva desiderata tramite il suo indice.
  3. Aggiungi un autoshape alla diapositiva selezionata.
  4. Accedi al TextFrame dell’autoshape.
  5. Rimuovi il paragrafo predefinito nel TextFrame.
  6. Crea la prima istanza di paragrafo usando la classe Paragraph.
  7. Imposta il Type del punto elenco per il paragrafo a Symbol e imposta il carattere del punto.
  8. Imposta il Text del paragrafo.
  9. Imposta l'Indent del paragrafo per il punto elenco.
  10. Imposta un colore per il punto elenco.
  11. Imposta l’altezza del punto elenco.
  12. Aggiungi il nuovo paragrafo alla raccolta di paragrafi del TextFrame.
  13. Aggiungi il secondo paragrafo e ripeti il processo indicato nei passaggi da 7 a 13.
  14. Salva la presentazione.
// Instanzia una classe Presentation che rappresenta un file PPTX
Presentation pres = new Presentation();
try {
    // Accede alla prima diapositiva
    ISlide slide = pres.getSlides().get_Item(0);
    
    // Aggiunge e accede all'Autoshape
    IAutoShape aShp = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);

    // Accede al frame di testo dell'autoshape
    ITextFrame txtFrm = aShp.getTextFrame();

    // Rimuove il paragrafo predefinito
    txtFrm.getParagraphs().removeAt(0);

    // Crea un paragrafo
    Paragraph para = new Paragraph();

    // Imposta lo stile e il simbolo del bullet del paragrafo
    para.getParagraphFormat().getBullet().setType(BulletType.Symbol);
    para.getParagraphFormat().getBullet().setChar((char)8226);

    // Imposta il testo del paragrafo
    para.setText("Welcome to Aspose.Slides");

    // Imposta il rientro del bullet
    para.getParagraphFormat().setIndent(25);

    // Imposta il colore del bullet
    para.getParagraphFormat().getBullet().getColor().setColorType(ColorType.RGB);
    para.getParagraphFormat().getBullet().getColor().setColor(Color.BLACK);
    para.getParagraphFormat().getBullet().setBulletHardColor(NullableBool.True); // imposta IsBulletHardColor a true per usare un colore bullet personalizzato

    // Imposta l'altezza del bullet
    para.getParagraphFormat().getBullet().setHeight(100);

    // Aggiunge il paragrafo al frame di testo
    txtFrm.getParagraphs().add(para);

    // Crea il secondo paragrafo
    Paragraph para2 = new Paragraph();

    // Imposta il tipo e lo stile del bullet del paragrafo
    para2.getParagraphFormat().getBullet().setType(BulletType.Numbered);
    para2.getParagraphFormat().getBullet().setNumberedBulletStyle(NumberedBulletStyle.BulletCircleNumWDBlackPlain);

    // Aggiunge il testo del paragrafo
    para2.setText("This is numbered bullet");

    // Imposta il rientro del bullet
    para2.getParagraphFormat().setIndent(25);

    para2.getParagraphFormat().getBullet().getColor().setColorType(ColorType.RGB);
    para2.getParagraphFormat().getBullet().getColor().setColor(Color.BLACK);
    para2.getParagraphFormat().getBullet().setBulletHardColor(NullableBool.True); // imposta IsBulletHardColor a true per usare un colore bullet personalizzato

    // Imposta l'altezza del bullet
    para2.getParagraphFormat().getBullet().setHeight(100);

    // Aggiunge il paragrafo al frame di testo
    txtFrm.getParagraphs().add(para2);
    
    // Salva la presentazione modificata
    pres.save("Bullet_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Gestire i punti elenco con immagine

Gli elenchi puntati ti aiutano a organizzare e presentare le informazioni rapidamente ed efficientemente. I paragrafi con immagine sono facili da leggere e comprendere.

  1. Crea un’istanza della classe Presentation.
  2. Accedi al riferimento della diapositiva desiderata tramite il suo indice.
  3. Aggiungi un autoshape alla diapositiva.
  4. Accedi al TextFrame dell’autoshape.
  5. Rimuovi il paragrafo predefinito nel TextFrame.
  6. Crea la prima istanza di paragrafo usando la classe Paragraph.
  7. Carica l’immagine in IPPImage.
  8. Imposta il tipo di punto elenco a Picture e imposta l’immagine.
  9. Imposta il Text del paragrafo.
  10. Imposta l'Indent del paragrafo per il punto elenco.
  11. Imposta un colore per il punto elenco.
  12. Imposta l’altezza del punto elenco.
  13. Aggiungi il nuovo paragrafo alla raccolta di paragrafi del TextFrame.
  14. Aggiungi il secondo paragrafo e ripeti il processo basato sui passaggi precedenti.
  15. Salva la presentazione modificata.
// Istanzia una classe Presentation che rappresenta un file PPTX
Presentation presentation = new Presentation();
try {
    // Accede alla prima diapositiva
    ISlide slide = presentation.getSlides().get_Item(0);

    // Istanzia l'immagine per i bullet
    IPPImage picture;
    IImage image = Images.fromFile("bullets.png");
    try {
        picture = presentation.getImages().addImage(image);
    } finally {
        if (image != null) image.dispose();
    }
    // Aggiunge e accede all'Autoshape
    IAutoShape autoShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);

    // Accede al textframe dell'autoshape
    ITextFrame textFrame = autoShape.getTextFrame();

    // Rimuove il paragrafo predefinito
    textFrame.getParagraphs().removeAt(0);

    // Crea un nuovo paragrafo
    Paragraph paragraph = new Paragraph();
    paragraph.setText("Welcome to Aspose.Slides");

    // Imposta lo stile del bullet del paragrafo e l'immagine
    paragraph.getParagraphFormat().getBullet().setType(BulletType.Picture);
    paragraph.getParagraphFormat().getBullet().getPicture().setImage(picture);

    // Imposta l'altezza del bullet
    paragraph.getParagraphFormat().getBullet().setHeight(100);

    // Aggiunge il paragrafo al frame di testo
    textFrame.getParagraphs().add(paragraph);

    // Scrive la presentazione come file PPTX
    presentation.save("ParagraphPictureBulletsPPTX_out.pptx", SaveFormat.Pptx);

    // Scrive la presentazione come file PPT
    presentation.save("ParagraphPictureBulletsPPT_out.ppt", SaveFormat.Ppt);
} catch (IOException e) {
} finally {
    if (presentation != null) presentation.dispose();
}

Gestire i punti elenco multilevel

Gli elenchi puntati ti aiutano a organizzare e presentare le informazioni rapidamente ed efficientemente. I punti elenco multilevel sono facili da leggere e comprendere.

  1. Crea un’istanza della classe Presentation.
  2. Accedi al riferimento della diapositiva desiderata tramite il suo indice.
  3. Aggiungi un autoshape nella nuova diapositiva.
  4. Accedi al TextFrame dell’autoshape.
  5. Rimuovi il paragrafo predefinito nel TextFrame.
  6. Crea la prima istanza di paragrafo tramite la classe Paragraph e imposta la profondità a 0.
  7. Crea la seconda istanza di paragrafo tramite la classe Paragraph e imposta la profondità a 1.
  8. Crea la terza istanza di paragrafo tramite la classe Paragraph e imposta la profondità a 2.
  9. Crea la quarta istanza di paragrafo tramite la classe Paragraph e imposta la profondità a 3.
  10. Aggiungi i nuovi paragrafi alla raccolta di paragrafi del TextFrame.
  11. Salva la presentazione modificata.
    // Istanzia una classe Presentation che rappresenta un file PPTX
    Presentation pres = new Presentation();
    try {
        // Accede alla prima diapositiva
        ISlide slide = pres.getSlides().get_Item(0);

        // Aggiunge e accede all'Autoshape
        IAutoShape aShp = slide.getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);

        // Accede al frame di testo dell'autoshape creata
        ITextFrame text = aShp.addTextFrame("");

        // Cancella il paragrafo predefinito
        text.getParagraphs().clear();

        // Aggiunge il primo paragrafo
        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);
        // Imposta il livello del bullet
        para1.getParagraphFormat().setDepth((short)0);

        // Aggiunge il secondo paragrafo
        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);
        // Imposta il livello del bullet
        para2.getParagraphFormat().setDepth((short)1);

        // Aggiunge il terzo paragrafo
        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);
        // Imposta il livello del bullet
        para3.getParagraphFormat().setDepth((short)2);

        // Aggiunge il quarto paragrafo
        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);
        // Imposta il livello del bullet
        para4.getParagraphFormat().setDepth((short)3);

        // Aggiunge i paragrafi alla raccolta
        text.getParagraphs().add(para1);
        text.getParagraphs().add(para2);
        text.getParagraphs().add(para3);
        text.getParagraphs().add(para4);

        // Scrive la presentazione come file PPTX
        pres.save("MultilevelBullet.pptx", SaveFormat.Pptx);
    } finally {
        if (pres != null) pres.dispose();
    }

Gestire un paragrafo con un elenco numerato personalizzato

L’interfaccia IBulletFormat fornisce la proprietà NumberedBulletStartWith e altre che consentono di gestire paragrafi con numerazione o formattazione personalizzata.

  1. Crea un’istanza della classe Presentation.
  2. Accedi alla diapositiva contenente il paragrafo.
  3. Aggiungi un autoshape alla diapositiva.
  4. Accedi al TextFrame dell’autoshape.
  5. Rimuovi il paragrafo predefinito nel TextFrame.
  6. Crea la prima istanza di paragrafo tramite la classe Paragraph e imposta NumberedBulletStartWith a 2.
  7. Crea la seconda istanza di paragrafo tramite la classe Paragraph e imposta NumberedBulletStartWith a 3.
  8. Crea la terza istanza di paragrafo tramite la classe Paragraph e imposta NumberedBulletStartWith a 7.
  9. Aggiungi i nuovi paragrafi alla raccolta di paragrafi del TextFrame.
  10. Salva la presentazione modificata.
Presentation presentation = new Presentation();
try {
    IAutoShape shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 200, 200, 400, 200);

    // Accede al frame di testo dell'autoshape creata
    ITextFrame textFrame = shape.getTextFrame();

    // Rimuove il paragrafo predefinito esistente
    textFrame.getParagraphs().removeAt(0);

    // Prima 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();
}

Impostare il rientro della prima riga per un paragrafo

Utilizza il metodo IParagraphFormat.setIndent per controllare il rientro della prima riga di un paragrafo. Questo metodo sposta solo la prima riga rispetto al margine sinistro del paragrafo. Un valore positivo sposta la prima riga verso destra, mentre le righe rimanenti rimangono allineate al corpo del paragrafo.

Usa IParagraphFormat.setMarginLeft quando devi spostare l’intero paragrafo. Usa IParagraphFormat.setIndent quando devi spostare solo la prima riga.

L’esempio seguente crea diversi paragrafi e applica valori di rientro differenti per dimostrare come il rientro della prima riga influisce sulla disposizione del paragrafo.

  1. Crea un’istanza della classe Presentation.
  2. Accedi alla diapositiva target.
  3. Aggiungi un AutoShape rettangolare alla diapositiva.
  4. Aggiungi un TextFrame vuoto alla forma e rimuovi il paragrafo predefinito.
  5. Crea diversi paragrafi e imposta valori diversi di Indent per ciascuno.
  6. Aggiungi i paragrafi al frame di testo.
  7. Salva la presentazione modificata.
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();
}

Il risultato:

Il rientro della prima riga dei paragrafi

Impostare il rientro sporgente per un paragrafo

Un rientro sporgente è una disposizione del paragrafo in cui la prima riga inizia a sinistra rispetto alle righe successive. In Aspose.Slides, crei questo effetto con il metodo IParagraphFormat.setIndent. Imposta il rientro a un valore negativo per spostare la prima riga a sinistra rispetto al corpo del paragrafo.

In pratica, IParagraphFormat.setMarginLeft definisce la posizione sinistra del corpo del paragrafo, e IParagraphFormat.setIndent definisce la posizione della prima riga rispetto a quel margine. Per creare un rientro sporgente, imposta un valore positivo di MarginLeft e un valore negativo di Indent.

Questa formattazione è utile per bibliografie, riferimenti, voci di glossario e altri paragrafi in cui le linee a capo devono allinearsi sotto il corpo del paragrafo anziché sotto il primo carattere della prima riga.

  1. Crea un’istanza della classe Presentation.
  2. Accedi alla diapositiva target.
  3. Aggiungi un AutoShape rettangolare alla diapositiva.
  4. Aggiungi un TextFrame vuoto alla forma e rimuovi il paragrafo predefinito.
  5. Crea paragrafi e imposta un valore positivo di MarginLeft per ciascun paragrafo.
  6. Imposta un valore negativo di Indent per creare l’effetto di rientro sporgente.
  7. Aggiungi i paragrafi al frame di testo.
  8. Salva la presentazione modificata.
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();
}

Il risultato:

Il rientro sporgente dei paragrafi

Gestire le proprietà End Run del paragrafo

  1. Crea un’istanza della classe Presentation.
  2. Ottieni il riferimento della diapositiva contenente il paragrafo tramite la sua posizione.
  3. Aggiungi un autoshape rettangolare alla diapositiva.
  4. Aggiungi un TextFrame con due paragrafi al rettangolo.
  5. Imposta FontHeight e il tipo di carattere per i paragrafi.
  6. Imposta le proprietà End per i paragrafi.
  7. Scrivi la presentazione modificata in formato PPTX.
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();
}

Importare testo HTML nei paragrafi

Aspose.Slides fornisce un supporto migliorato per l’importazione di testo HTML nei paragrafi.

  1. Crea un’istanza della classe Presentation.
  2. Accedi al riferimento della diapositiva desiderata tramite il suo indice.
  3. Aggiungi un autoshape alla diapositiva.
  4. Aggiungi e accedi al ITextFrame dell'autoshape.
  5. Rimuovi il paragrafo predefinito nel ITextFrame.
  6. Leggi il file HTML sorgente con un TextReader.
  7. Crea la prima istanza di paragrafo tramite la classe Paragraph.
  8. Aggiungi il contenuto del file HTML letto dal TextReader alla ParagraphCollection del TextFrame.
  9. Salva la presentazione modificata.
// Crea un'istanza di presentazione vuota
Presentation pres = new Presentation();
try {
    // Accede alla diapositiva predefinita iniziale della presentazione
    ISlide slide = pres.getSlides().get_Item(0);

    // Aggiunge l'AutoShape per contenere il contenuto HTML
    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);

    // Aggiunge il frame di testo alla forma
    ashape.addTextFrame("");

    // Cancella tutti i paragrafi nel frame di testo aggiunto
    ashape.getTextFrame().getParagraphs().clear();

    // Carica il file HTML usando lo stream reader
    TextReader tr = new StreamReader("file.html");

    // Aggiunge il testo dallo stream reader HTML nel frame di testo
    ashape.getTextFrame().getParagraphs().addFromHtml(tr.readToEnd());

    // Salva la presentazione
    pres.save("output_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Esportare il testo del paragrafo in HTML

Aspose.Slides fornisce un supporto migliorato per l’esportazione di testi (contenuti nei paragrafi) in HTML.

  1. Crea un’istanza della classe Presentation e carica la presentazione desiderata.
  2. Accedi al riferimento della diapositiva desiderata tramite il suo indice.
  3. Accedi alla forma che contiene il testo da esportare in HTML.
  4. Accedi al TextFrame della forma.
  5. Crea un’istanza di StreamWriter e aggiungi il nuovo file HTML.
  6. Fornisci un indice di partenza a StreamWriter ed esporta i paragrafi desiderati.
// Carica il file di presentazione
Presentation pres = new Presentation("ExportingHTMLText.pptx");
try {
    // Accede alla diapositiva predefinita iniziale della presentazione
    ISlide slide = pres.getSlides().get_Item(0);

    // Indice desiderato
    int index = 0;

    // Accesso alla forma aggiunta
    IAutoShape ashape = (IAutoShape) slide.getShapes().get_Item(index);

    // Creazione del file HTML di output
    OutputStream os = new FileOutputStream("output.html");
    Writer writer = new OutputStreamWriter(os, "UTF-8");

    // Estrae il primo paragrafo come HTML
    // Scrive i dati dei paragrafi in HTML fornendo l'indice di partenza del paragrafo, il numero totale di paragrafi da copiare
    writer.write(ashape.getTextFrame().getParagraphs().exportToHtml(0, ashape.getTextFrame().getParagraphs().getCount(), null));
    writer.close();
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

Salvare un paragrafo come immagine

In questa sezione esploreremo due esempi che mostrano come salvare un paragrafo di testo, rappresentato dall’interfaccia IParagraph, come immagine. Entrambi gli esempi includono l’ottenimento dell’immagine di una forma contenente il paragrafo usando i metodi getImage dell’interfaccia IShape, il calcolo dei limiti del paragrafo all’interno della forma e l’esportazione come immagine bitmap. Questi approcci consentono di estrarre parti specifiche del testo da presentazioni PowerPoint e salvarle come immagini separate, utile in vari scenari.

Supponiamo di avere un file di presentazione chiamato sample.pptx con una diapositiva, in cui la prima forma è una casella di testo contenente tre paragrafi.

La casella di testo con tre paragrafi

Esempio 1

In questo esempio, otteniamo il secondo paragrafo come immagine. Per farlo, estraiamo l’immagine della forma dalla prima diapositiva della presentazione e poi calcoliamo i limiti del secondo paragrafo nel frame di testo della forma. Il paragrafo viene quindi ridisegnato su una nuova immagine bitmap, che viene salvata in formato PNG. Questo metodo è particolarmente utile quando è necessario salvare un paragrafo specifico come immagine separata mantenendo le dimensioni e la formattazione esatte del testo.

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

    // Salva la forma in memoria come bitmap.
    IImage shapeImage = firstShape.getImage();
    ByteArrayOutputStream shapeImageStream = new ByteArrayOutputStream();
    shapeImage.save(shapeImageStream, ImageFormat.Png);
    shapeImage.dispose();

    // Crea un bitmap della forma dalla memoria.
    InputStream shapeImageInputStream = new ByteArrayInputStream(shapeImageStream.toByteArray());
    BufferedImage shapeBitmap = ImageIO.read(shapeImageInputStream);

    // Calcola i confini del secondo paragrafo.
    IParagraph secondParagraph = firstShape.getTextFrame().getParagraphs().get_Item(1);
    RectF paragraphRectangle = secondParagraph.getRect();

    // Calcola le coordinate e le dimensioni per l'immagine di output (dimensione minima - 1x1 pixel).
    int imageX = (int) Math.floor(paragraphRectangle.left);
    int imageY = (int) Math.floor(paragraphRectangle.top);
    int imageWidth = Math.max(1, (int) Math.ceil(paragraphRectangle.width()));
    int imageHeight = Math.max(1, (int) Math.ceil(paragraphRectangle.height()));

    // Ritaglia il bitmap della forma per ottenere solo il bitmap del paragrafo.
    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();
}

Il risultato:

L’immagine del paragrafo

Esempio 2

In questo esempio, estendiamo l’approccio precedente aggiungendo fattori di scala all’immagine del paragrafo. La forma è estratta dalla presentazione e salvata come immagine con un fattore di scala di 2. Ciò consente un’output a risoluzione più alta durante l’esportazione del paragrafo. I limiti del paragrafo vengono quindi calcolati tenendo conto della scala. La scalatura può essere particolarmente utile quando è necessaria un’immagine più dettagliata, ad esempio per materiali stampati di alta qualità.

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);

    // Salva la forma in memoria come bitmap con ridimensionamento.
    IImage shapeImage = firstShape.getImage(ShapeThumbnailBounds.Shape, imageScaleX, imageScaleY);
    ByteArrayOutputStream shapeImageStream = new ByteArrayOutputStream();
    shapeImage.save(shapeImageStream, ImageFormat.Png);
    shapeImage.dispose();

    // Crea un bitmap della forma dalla memoria.
    InputStream shapeImageInputStream = new ByteArrayInputStream(shapeImageStream.toByteArray());
    BufferedImage shapeBitmap = ImageIO.read(shapeImageInputStream);

    // Calcola i confini del secondo paragrafo.
    IParagraph secondParagraph = firstShape.getTextFrame().getParagraphs().get_Item(1);
    RectF paragraphRectangle = secondParagraph.getRect();
    paragraphRectangle.set(
            paragraphRectangle.left * imageScaleX,
            paragraphRectangle.top * imageScaleY,
            paragraphRectangle.right * imageScaleX,
            paragraphRectangle.bottom * imageScaleY
    );

    // Calcola le coordinate e le dimensioni per l'immagine di output (dimensione minima - 1x1 pixel).
    int imageX = (int) Math.floor(paragraphRectangle.left);
    int imageY = (int) Math.floor(paragraphRectangle.top);
    int imageWidth = Math.max(1, (int) Math.ceil(paragraphRectangle.width()));
    int imageHeight = Math.max(1, (int) Math.ceil(paragraphRectangle.height()));

    // Ritaglia il bitmap della forma per ottenere solo il bitmap del paragrafo.
    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

Posso disattivare completamente a capo automatico all’interno di un text frame?

Sì. Usa l’impostazione di avvolgimento del text frame (setWrapText) per disattivare l’avvolgimento in modo che le linee non si interrompano ai bordi del frame.

Come posso ottenere i limiti esatti su diapositiva di un paragrafo specifico?

Puoi recuperare il rettangolo di delimitazione del paragrafo (e anche di una singola porzione) per conoscere la sua posizione e dimensione precise sulla diapositiva.

Dove viene controllato l’allineamento del paragrafo (sinistra/destra/centrato/giustificato)?

Alignment è un’impostazione a livello di paragrafo in ParagraphFormat; si applica all’intero paragrafo indipendentemente dalla formattazione delle singole porzioni.

Posso impostare una lingua di correzione ortografica per una sola parte di un paragrafo (ad es., una parola)?

Sì. La lingua viene impostata a livello di porzione (PortionFormat.setLanguageId), quindi più lingue possono coesistere all’interno di un singolo paragrafo.

Migliora le tue presentazioni con AutoFit su Android Ottenere i limiti del paragrafo dalle presentazioni su Android