Gestire i paragrafi di testo PowerPoint in Python

Introduzione

Aspose.Slides fornisce le classi necessarie per lavorare con il testo di PowerPoint in Python.

  • Aspose.Slides fornisce la classe TextFrame per creare oggetti di riquadro di testo. Un oggetto TextFrame può contenere uno o più paragrafi (ogni paragrafo è separato da un ritorno a capo).
  • Aspose.Slides fornisce la classe Paragraph per creare oggetti paragrafo. Un oggetto Paragraph può contenere una o più porzioni di testo.
  • Aspose.Slides fornisce la classe Portion per creare oggetti porzione di testo e specificare le loro proprietà di formattazione.

Un oggetto Paragraph può gestire testo con diverse proprietà di formattazione tramite i suoi oggetti Portion sottostanti.

Aggiungere più paragrafi contenenti più porzioni

Questi passaggi mostrano come aggiungere un riquadro di testo che contiene tre paragrafi, ognuno con tre porzioni:

  1. Crea un’istanza della classe Presentation.
  2. Ottieni un riferimento alla diapositiva di destinazione tramite il suo indice.
  3. Aggiungi una AutoShape rettangolare alla diapositiva.
  4. Ottieni il TextFrame associato alla AutoShape.
  5. Crea due oggetti Paragraph e aggiungili alla raccolta di paragrafi del TextFrame (insieme al paragrafo predefinito, questo porta a tre paragrafi).
  6. Per ciascun paragrafo, crea tre oggetti Portion e aggiungili alla raccolta di porzioni di quel paragrafo.
  7. Imposta il testo per ciascuna porzione.
  8. Applica la formattazione desiderata a ogni porzione di testo usando le proprietà esposte da Portion.
  9. Salva la presentazione modificata.

Il seguente codice Python implementa questi passaggi:

import aspose.slides as slides
import aspose.pydrawing as draw

# Istanziate la classe Presentation per creare un nuovo file PPTX.
with slides.Presentation() as presentation:

    # Accedete alla prima diapositiva.
    slide = presentation.slides[0]

    # Aggiungete una AutoShape rettangolare.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 150, 300, 150)

    # Accedete al TextFrame dell'AutoShape.
    text_frame = shape.text_frame

    # Create paragrafi e porzioni; la formattazione viene applicata di seguito.
    paragraph0 = text_frame.paragraphs[0]
    portion01 = slides.Portion()
    portion02 = slides.Portion()
    paragraph0.portions.add(portion01)
    paragraph0.portions.add(portion02)

    paragraph1 = slides.Paragraph()
    text_frame.paragraphs.add(paragraph1)
    portion10 = slides.Portion()
    portion11 = slides.Portion()
    portion12 = slides.Portion()
    paragraph1.portions.add(portion10)
    paragraph1.portions.add(portion11)
    paragraph1.portions.add(portion12)

    paragraph2 = slides.Paragraph()
    text_frame.paragraphs.add(paragraph2)
    portion20 = slides.Portion()
    portion21 = slides.Portion()
    portion22 = slides.Portion()
    paragraph2.portions.add(portion20)
    paragraph2.portions.add(portion21)
    paragraph2.portions.add(portion22)

    for i in range(3):
        for j in range(3):
            text_frame.paragraphs[i].portions[j].text = "Portion0" + str(j)
            if j == 0:
                text_frame.paragraphs[i].portions[j].portion_format.fill_format.fill_type = slides.FillType.SOLID
                text_frame.paragraphs[i].portions[j].portion_format.fill_format.solid_fill_color.color = draw.Color.red
                text_frame.paragraphs[i].portions[j].portion_format.font_bold = 1
                text_frame.paragraphs[i].portions[j].portion_format.font_height = 15
            elif j == 1:
                text_frame.paragraphs[i].portions[j].portion_format.fill_format.fill_type = slides.FillType.SOLID
                text_frame.paragraphs[i].portions[j].portion_format.fill_format.solid_fill_color.color = draw.Color.blue
                text_frame.paragraphs[i].portions[j].portion_format.font_italic = 1
                text_frame.paragraphs[i].portions[j].portion_format.font_height = 18

    # Salva il PPTX su disco.
    presentation.save("paragraphs_and_portions_out.pptx", slides.export.SaveFormat.PPTX)

Gestire i punti elenco dei paragrafi

Le liste puntate ti aiutano a organizzare e presentare le informazioni rapidamente ed efficientemente. I paragrafi con punti elenco sono spesso più facili da leggere e comprendere.

  1. Crea un’istanza della classe Presentation.
  2. Accedi alla diapositiva di destinazione tramite il suo indice.
  3. Aggiungi una AutoShape alla diapositiva.
  4. Accedi al TextFrame della forma.
  5. Rimuovi il paragrafo predefinito dal TextFrame.
  6. Crea il primo paragrafo usando la classe Paragraph.
  7. Imposta il tipo di punto elenco del paragrafo su SYMBOL e specifica il carattere del punto elenco.
  8. Imposta il testo del paragrafo.
  9. Imposta il rientro del punto elenco per il paragrafo.
  10. Imposta il colore del punto elenco.
  11. Imposta la dimensione (altezza) del punto elenco.
  12. Aggiungi il paragrafo alla raccolta di paragrafi del TextFrame.
  13. Aggiungi un secondo paragrafo e ripeti i passaggi 7–12.
  14. Salva la presentazione.

Questo codice Python mostra come aggiungere paragrafi puntati:

import aspose.slides as slides
import aspose.pydrawing as draw

# Crea un'istanza di presentazione.
with slides.Presentation() as presentation:

    # Accedi alla prima diapositiva.
    slide = presentation.slides[0]

    # Aggiungi e accedi a un'AutoShape.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 200, 400, 200)

    # Accedi al riquadro di testo dell'AutoShape creata.
    text_frame = shape.text_frame

    # Rimuovi il paragrafo predefinito.
    text_frame.paragraphs.remove_at(0)

    # Crea un paragrafo.
    paragraph = slides.Paragraph()

    # Imposta lo stile e il simbolo del punto elenco del paragrafo.
    paragraph.paragraph_format.bullet.type = slides.BulletType.SYMBOL
    paragraph.paragraph_format.bullet.char = chr(8226)

    # Imposta il testo del paragrafo.
    paragraph.text = "Welcome to Aspose.Slides"

    # Imposta il rientro del punto elenco.
    paragraph.paragraph_format.indent = 25

    # Imposta il colore del punto elenco.
    paragraph.paragraph_format.bullet.color.color_type = slides.ColorType.RGB
    paragraph.paragraph_format.bullet.color.color = draw.Color.black
    paragraph.paragraph_format.bullet.is_bullet_hard_color = 1 

    # Imposta l'altezza del punto elenco.
    paragraph.paragraph_format.bullet.height = 100

    # Aggiungi il paragrafo al riquadro di testo.
    text_frame.paragraphs.add(paragraph)

    # Crea il secondo paragrafo.
    paragraph2 = slides.Paragraph()

    # Imposta il tipo e lo stile del punto elenco del paragrafo.
    paragraph2.paragraph_format.bullet.type = slides.BulletType.NUMBERED
    paragraph2.paragraph_format.bullet.numbered_bullet_style = slides.NumberedBulletStyle.BULLET_CIRCLE_NUM_WDBLACK_PLAIN

    # Imposta il testo del paragrafo.
    paragraph2.text = "This is numbered bullet"

    # Imposta il rientro del punto elenco.
    paragraph2.paragraph_format.indent = 25

    # Imposta il colore del punto elenco.
    paragraph2.paragraph_format.bullet.color.color_type = slides.ColorType.RGB
    paragraph2.paragraph_format.bullet.color.color = draw.Color.black
    paragraph2.paragraph_format.bullet.is_bullet_hard_color = 1

    # Imposta l'altezza del punto elenco.
    paragraph2.paragraph_format.bullet.height = 100

    # Aggiungi il paragrafo al riquadro di testo.
    text_frame.paragraphs.add(paragraph2)

    # Salva la presentazione come file PPTX.
    presentation.save("bullets_out.pptx", slides.export.SaveFormat.PPTX)

Gestire i punti elenco con immagini

Le liste puntate ti aiutano a organizzare e presentare le informazioni rapidamente ed efficientemente. I punti elenco con immagine sono facili da leggere e comprendere.

  1. Crea un’istanza della classe Presentation.
  2. Accedi alla diapositiva di destinazione tramite il suo indice.
  3. Aggiungi una AutoShape alla diapositiva.
  4. Accedi al TextFrame della forma.
  5. Rimuovi il paragrafo predefinito dal TextFrame.
  6. Crea il primo paragrafo usando la classe Paragraph.
  7. Carica un’immagine in un PPImage.
  8. Imposta il tipo di punto elenco su PPImage e assegna l’immagine.
  9. Imposta il testo del paragrafo.
  10. Imposta il rientro del paragrafo per il punto elenco.
  11. Imposta il colore del punto elenco.
  12. Imposta l’altezza del punto elenco.
  13. Aggiungi il nuovo paragrafo alla raccolta di paragrafi del TextFrame.
  14. Aggiungi un secondo paragrafo e ripeti i passaggi 8–12.
  15. Salva la presentazione.

Questo codice Python mostra come aggiungere e gestire i punti elenco con immagini:

import aspose.slides as slides
import aspose.pydrawing as draw

with slides.Presentation() as presentation:

    # Accedi alla prima diapositiva.
    slide = presentation.slides[0]

    # Carica l'immagine del punto elenco.
    image = draw.Bitmap("bullets.png")
    pp_image = presentation.images.add_image(image)

    # Aggiungi e accedi a un'AutoShape.
    auto_shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 200, 400, 200)

    # Accedi al TextFrame dell'AutoShape creata.
    text_frame = auto_shape.text_frame

    # Rimuovi il paragrafo predefinito.
    text_frame.paragraphs.remove_at(0)

    # Crea un nuovo paragrafo.
    paragraph = slides.Paragraph()
    paragraph.text = "Welcome to Aspose.Slides"

    # Imposta il tipo di punto elenco del paragrafo su Immagine e assegna l'immagine.
    paragraph.paragraph_format.bullet.type = slides.BulletType.PICTURE
    paragraph.paragraph_format.bullet.picture.image = pp_image

    # Imposta l'altezza del punto elenco.
    paragraph.paragraph_format.bullet.height = 100

    # Aggiungi il paragrafo al riquadro di testo.
    text_frame.paragraphs.add(paragraph)

    # Salva la presentazione come file PPTX.
    presentation.save("picture_bullets_out.pptx", slides.export.SaveFormat.PPTX)
    # Salva la presentazione come file PPT.
    presentation.save("picture_bullets_out.ppt", slides.export.SaveFormat.PPT)

Gestire i punti elenco multilivello

Le liste puntate ti aiutano a organizzare e presentare le informazioni rapidamente ed efficientemente. I punti elenco multilivello sono facili da leggere e comprendere.

  1. Crea un’istanza della classe Presentation.
  2. Accedi alla diapositiva di destinazione tramite il suo indice.
  3. Aggiungi una AutoShape alla diapositiva.
  4. Accedi al TextFrame dell'AutoShape.
  5. Rimuovi il paragrafo predefinito dal TextFrame.
  6. Crea il primo paragrafo usando la classe [Paragraph] e imposta la sua profondità a 0.
  7. Crea il secondo paragrafo usando la classe [Paragraph] e imposta la sua profondità a 1.
  8. Crea il terzo paragrafo usando la classe [Paragraph] e imposta la sua profondità a 2.
  9. Crea il quarto paragrafo usando la classe [Paragraph] e imposta la sua profondità a 3.
  10. Aggiungi i nuovi paragrafi alla raccolta di paragrafi del TextFrame.
  11. Salva la presentazione.

Il seguente codice Python mostra come aggiungere e gestire i punti elenco multilivello:

import aspose.slides as slides
import aspose.pydrawing as draw

# Crea un'istanza di presentazione.
with slides.Presentation() as presentation:

    # Accedi alla prima diapositiva.
    slide = presentation.slides[0]
    
    # Aggiungi un'AutoShape.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 200, 400, 200)

    # Accedi al TextFrame dell'AutoShape creata.
    text_frame = auto_shape.text_frame
    
    # Pulisci il paragrafo predefinito.
    text_frame.paragraphs.clear()

    # Aggiungi il primo paragrafo.
    paragraph1 = slides.Paragraph()
    paragraph1.text = "Content"
    paragraph1.paragraph_format.bullet.type = slides.BulletType.SYMBOL
    paragraph1.paragraph_format.bullet.char = chr(8226)
    paragraph1.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    paragraph1.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    # Imposta il livello del punto elenco.
    paragraph1.paragraph_format.depth = 0

    # Aggiungi il secondo paragrafo.
    paragraph2 = slides.Paragraph()
    paragraph2.text = "Second Level"
    paragraph2.paragraph_format.bullet.type = slides.BulletType.SYMBOL
    paragraph2.paragraph_format.bullet.char = '-'
    paragraph2.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    paragraph2.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    # Imposta il livello del punto elenco.
    paragraph2.paragraph_format.depth = 1

    # Aggiungi il terzo paragrafo.
    paragraph3 = slides.Paragraph()
    paragraph3.text = "Third Level"
    paragraph3.paragraph_format.bullet.type = slides.BulletType.SYMBOL
    paragraph3.paragraph_format.bullet.char = chr(8226)
    paragraph3.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    paragraph3.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    # Imposta il livello del punto elenco.
    paragraph3.paragraph_format.depth = 2

    # Aggiungi il quarto paragrafo.
    paragraph4 = slides.Paragraph()
    paragraph4.text = "Fourth Level"
    paragraph4.paragraph_format.bullet.type = slides.BulletType.SYMBOL
    paragraph4.paragraph_format.bullet.char = '-'
    paragraph4.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    paragraph4.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    # Imposta il livello del punto elenco.
    paragraph4.paragraph_format.depth = 3

    # Aggiungi i paragrafi alla raccolta.
    text_frame.paragraphs.add(paragraph1)
    text_frame.paragraphs.add(paragraph2)
    text_frame.paragraphs.add(paragraph3)
    text_frame.paragraphs.add(paragraph4)

    # Salva la presentazione come file PPTX.
    presentation.save("multilevel_bullets_out.pptx", slides.export.SaveFormat.PPTX)

Gestire i paragrafi con elenchi numerati personalizzati

La classe BulletFormat fornisce la proprietà numbered_bullet_start_with (e altre) per controllare la numerazione e la formattazione personalizzate dei paragrafi.

  1. Crea un’istanza della classe Presentation.
  2. Accedi alla diapositiva che conterrà i paragrafi.
  3. Aggiungi una AutoShape alla diapositiva.
  4. Accedi al TextFrame della forma.
  5. Rimuovi il paragrafo predefinito dal TextFrame.
  6. Crea il primo [Paragraph] e imposta numbered_bullet_start_with a 2.
  7. Crea il secondo [Paragraph] e imposta numbered_bullet_start_with a 3.
  8. Crea il terzo [Paragraph] e imposta numbered_bullet_start_with a 7.
  9. Aggiungi i paragrafi alla raccolta del TextFrame.
  10. Salva la presentazione.

Il seguente codice Python dimostra come aggiungere e gestire paragrafi con numerazione e formattazione personalizzate.

import aspose.slides as slides

with slides.Presentation() as presentation:

    # Aggiungi e accedi a un'AutoShape.
    shape = presentation.slides[0].shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 200, 400, 200)

    # Accedi al TextFrame dell'AutoShape creata.
    text_frame = shape.text_frame

    # Rimuovi il paragrafo predefinito esistente.
    text_frame.paragraphs.remove_at(0)

    # Crea il primo elemento numerato (inizia a 2, livello di profondità 4).
    paragraph1 = slides.Paragraph()
    paragraph1.text = "bullet 2"
    paragraph1.paragraph_format.depth = 4 
    paragraph1.paragraph_format.bullet.numbered_bullet_start_with = 2
    paragraph1.paragraph_format.bullet.type = slides.BulletType.NUMBERED
    text_frame.paragraphs.add(paragraph1)

    # Crea il secondo elemento numerato (inizia a 3, livello di profondità 4).
    paragraph2 = slides.Paragraph()
    paragraph2.text = "bullet 3"
    paragraph2.paragraph_format.depth = 4
    paragraph2.paragraph_format.bullet.numbered_bullet_start_with = 3 
    paragraph2.paragraph_format.bullet.type = slides.BulletType.NUMBERED  
    text_frame.paragraphs.add(paragraph2)

    # Crea il terzo elemento numerato (inizia a 7, livello di profondità 4).
    paragraph5 = slides.Paragraph()
    paragraph5.text = "bullet 7"
    paragraph5.paragraph_format.depth = 4
    paragraph5.paragraph_format.bullet.numbered_bullet_start_with = 7
    paragraph5.paragraph_format.bullet.type = slides.BulletType.NUMBERED
    text_frame.paragraphs.add(paragraph5)

    presentation.save("custom_bullets_out.pptx", slides.export.SaveFormat.PPTX)

Impostare il rientro della prima riga per un paragrafo

Usa la proprietà ParagraphFormat.indent per controllare il rientro della prima riga di un paragrafo. Questa proprietà sposta solo la prima riga rispetto al margine sinistro del paragrafo. Un valore positivo sposta la prima riga verso destra, mentre le linee rimanenti rimangono allineate al corpo del paragrafo.

Usa ParagraphFormat.margin_left quando è necessario spostare l’intero paragrafo. Usa ParagraphFormat.indent quando è necessario spostare solo la prima riga.

L’esempio seguente crea diversi paragrafi e applica valori diversi di indent per dimostrare come il rientro della prima riga influisce sul layout del paragrafo.

  1. Crea un’istanza della classe Presentation.
  2. Accedi alla diapositiva di destinazione.
  3. Aggiungi una 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 riquadro di testo.
  7. Salva la presentazione modificata.

Questo codice mostra come impostare il rientro di un paragrafo:

import aspose.slides as slides
import aspose.pydrawing as draw

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    rectangle = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 420, 220)
    rectangle.fill_format.fill_type = slides.FillType.NO_FILL
    rectangle.line_format.fill_format.fill_type = slides.FillType.SOLID
    rectangle.line_format.fill_format.solid_fill_color.color = draw.Color.gray

    text_frame = rectangle.add_text_frame("")
    text_frame.text_frame_format.autofit_type = slides.TextAutofitType.SHAPE
    text_frame.paragraphs.remove_at(0)

    first_paragraph = slides.Paragraph()
    first_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    first_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    first_paragraph.text = "No first-line indent. Wrapped lines start at the same position as the first line."
    first_paragraph.paragraph_format.margin_left = 20.0
    first_paragraph.paragraph_format.indent = 0.0

    second_paragraph = slides.Paragraph()
    second_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    second_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    second_paragraph.text = "First-line indent of 20 points. The first line moves to the right, while wrapped lines remain aligned to the paragraph body."
    second_paragraph.paragraph_format.margin_left = 20.0
    second_paragraph.paragraph_format.indent = 20.0

    third_paragraph = slides.Paragraph()
    third_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    third_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    third_paragraph.text = "First-line indent of 40 points. This paragraph shows a larger first-line offset to make the effect easier to see."
    third_paragraph.paragraph_format.margin_left = 20.0
    third_paragraph.paragraph_format.indent = 40.0

    text_frame.paragraphs.add(first_paragraph)
    text_frame.paragraphs.add(second_paragraph)
    text_frame.paragraphs.add(third_paragraph)

    presentation.save("paragraph_indent.pptx", slides.export.SaveFormat.PPTX)

Il risultato:

Il rientro della prima riga dei paragrafi

Impostare il rientro sospeso per un paragrafo

Un rientro sospeso è un layout di paragrafo in cui la prima riga inizia a sinistra delle righe rimanenti. In Aspose.Slides, crei questo effetto con la proprietà ParagraphFormat.indent. Imposta indent a un valore negativo per spostare la prima riga a sinistra rispetto al corpo del paragrafo.

In pratica, ParagraphFormat.margin_left definisce la posizione sinistra del corpo del paragrafo, e ParagraphFormat.indent definisce la posizione della prima riga rispetto a quel margine. Per creare un rientro sospeso, imposta un valore positivo per margin_left e un valore negativo per 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 di destinazione.
  3. Aggiungi una 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 margin_left per ciascun paragrafo.
  6. Imposta un valore negativo di indent per creare l’effetto di rientro sospeso.
  7. Aggiungi i paragrafi al riquadro di testo.
  8. Salva la presentazione modificata.

Questo codice mostra come impostare un rientro sospeso per un paragrafo:

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    rectangle = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 420, 220)
    rectangle.fill_format.fill_type = slides.FillType.NO_FILL
    rectangle.line_format.fill_format.fill_type = slides.FillType.SOLID
    rectangle.line_format.fill_format.solid_fill_color.color = draw.Color.gray

    text_frame = rectangle.add_text_frame("")
    text_frame.text_frame_format.autofit_type = slides.TextAutofitType.SHAPE
    text_frame.paragraphs.remove_at(0)

    first_paragraph = slides.Paragraph()
    first_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    first_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    first_paragraph.text = "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."
    first_paragraph.paragraph_format.margin_left = 40.0
    first_paragraph.paragraph_format.indent = -20.0

    second_paragraph = slides.Paragraph()
    second_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    second_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    second_paragraph.text = "This second example uses a deeper hanging indent so the difference between the first line and the wrapped lines is easier to compare."
    second_paragraph.paragraph_format.margin_left = 60.0
    second_paragraph.paragraph_format.indent = -30.0

    text_frame.paragraphs.add(first_paragraph)
    text_frame.paragraphs.add(second_paragraph)

    presentation.save("hanging_indent.pptx", slides.export.SaveFormat.PPTX)

Il risultato:

Il rientro sospeso dei paragrafi

Gestire il formato della porzione di fine paragrafo

Quando è necessario controllare lo stile della “fine” di un paragrafo (la formattazione applicata dopo l’ultima porzione di testo), usa la proprietà end_paragraph_portion_format. L’esempio seguente applica un carattere Times New Roman più grande alla fine del secondo paragrafo.

  1. Crea o apri un file [Presentation].
  2. Ottieni la diapositiva di destinazione per indice.
  3. Aggiungi un [AutoShape] rettangolare alla diapositiva.
  4. Usa il [TextFrame] della forma e crea due paragrafi.
  5. Crea un [PortionFormat] impostato a Times New Roman 48 pt e applicalo come formato di porzione di fine paragrafo del paragrafo.
  6. Assegnalo al end_paragraph_portion_format del paragrafo (si applica alla fine del secondo paragrafo).
  7. Salva la presentazione modificata come file PPTX.

Questo codice Python mostra come impostare la formattazione di fine paragrafo per il secondo paragrafo:

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
	shape = presentation.slides[0].shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, 200, 250)

	paragraph1 = slides.Paragraph()
	paragraph1.portions.add(slides.Portion("Sample text"))

	end_paragraph_portion_format = slides.PortionFormat()
	end_paragraph_portion_format.font_height = 48
	end_paragraph_portion_format.latin_font = slides.FontData("Times New Roman")

	paragraph2 = slides.Paragraph()
	paragraph2.portions.add(slides.Portion("Sample text 2"))
	paragraph2.end_paragraph_portion_format = end_paragraph_portion_format

	shape.text_frame.paragraphs.add(paragraph1)
	shape.text_frame.paragraphs.add(paragraph2)

	presentation.save("presentation.pptx", slides.export.SaveFormat.PPTX)

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 alla diapositiva di destinazione tramite il suo indice.
  3. Aggiungi una AutoShape alla diapositiva.
  4. Accedi al [TextFrame] dell'AutoShape.
  5. Rimuovi il paragrafo predefinito dal TextFrame.
  6. Leggi il file HTML sorgente.
  7. Crea il primo paragrafo usando la classe Paragraph.
  8. Aggiungi il contenuto HTML alla raccolta di paragrafi del TextFrame.
  9. Salva la presentazione modificata.

Il seguente codice Python implementa questi passaggi per importare testo HTML nei paragrafi:

import aspose.slides as slides

# Crea un'istanza vuota di Presentation.
with slides.Presentation() as presentation:

    # Accedi alla prima diapositiva della presentazione.
    slide = presentation.slides[0]

    slide_width = presentation.slide_size.size.width
    slide_height = presentation.slide_size.size.height

    # Aggiungi un'AutoShape per contenere il contenuto HTML.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, slide_width - 20, slide_height - 10)

    # Pulisci tutti i paragrafi nel riquadro di testo aggiunto.
    shape.text_frame.paragraphs.clear()

    # Carica il file HTML.
    with open("file.html", "rt") as html_stream:
        # Aggiungi il testo dal file HTML al riquadro di testo.
        shape.text_frame.paragraphs.add_from_html(html_stream.read())

    # Salva la presentazione.
    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

Esportare il testo del paragrafo in HTML

Aspose.Slides fornisce un supporto migliorato per l’esportazione di testo in HTML.

  1. Crea un’istanza della classe Presentation e carica la presentazione di destinazione.
  2. Accedi alla diapositiva desiderata tramite il suo indice.
  3. Seleziona la forma che contiene il testo da esportare.
  4. Accedi al TextFrame della forma.
  5. Apri uno stream di file per scrivere l’output HTML.
  6. Specifica l’indice di partenza ed esporta i paragrafi richiesti.

Questo esempio Python mostra come esportare il testo del paragrafo in HTML.

import aspose.slides as slides

# Carica il file di presentazione.
with slides.Presentation("exporting_HTML_text.pptx") as presentation:
    # Accedi alla prima diapositiva della presentazione.
    slide = presentation.slides[0]

    # Indice della forma di destinazione.
    index = 0

    # Accedi alla forma tramite indice.
    shape = slide.shapes[index]

    with open("output.html", "w") as html_stream:
        # Scrivi i dati del paragrafo in HTML fornendo l'indice di partenza del paragrafo e il numero totale di paragrafi da esportare.
        html_stream.write(shape.text_frame.paragraphs.export_to_html(0, shape.text_frame.paragraphs.count, None))

Salvare un paragrafo come immagine

In questa sezione esploreremo due esempi che dimostrano come salvare un paragrafo di testo, rappresentato dalla classe [Paragraph], come immagine. Entrambi gli esempi includono l’ottenimento dell’immagine di una forma contenente il paragrafo usando i metodi get_image della classe [Shape], 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 dalle presentazioni PowerPoint e salvarle come immagini separate, utile per ulteriori utilizzi 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 calcoliamo i limiti del secondo paragrafo nel riquadro 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 preservando le dimensioni e la formattazione esatte del testo.

import aspose.slides as slides
import math
import io
from PIL import Image

with slides.Presentation("sample.pptx") as presentation:
    first_shape = presentation.slides[0].shapes[0]

    # Salva la forma in memoria come bitmap.
    with first_shape.get_image() as shape_image:
        shape_image_stream = io.BytesIO()
        shape_image.save(shape_image_stream, slides.ImageFormat.PNG)

    # Crea un bitmap della forma dalla memoria.
    shape_image_stream.seek(0)
    shape_bitmap = Image.open(shape_image_stream)

    # Calcola i confini del secondo paragrafo.
    second_paragraph = first_shape.text_frame.paragraphs[1]
    paragraph_rectangle = second_paragraph.get_rect()

    # Calcola le coordinate e le dimensioni dell'immagine di output (dimensione minima - 1x1 pixel).
    image_left = math.floor(paragraph_rectangle.x)
    image_top = math.floor(paragraph_rectangle.y)
    image_right = image_left + max(1, math.ceil(paragraph_rectangle.width))
    image_bottom = image_top + max(1, math.ceil(paragraph_rectangle.height))

    # Ritaglia il bitmap della forma per ottenere solo il bitmap del paragrafo.
    paragraph_bitmap = shape_bitmap.crop((image_left, image_top, image_right, image_bottom))

    paragraph_bitmap.save("paragraph.png")

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 viene estratta dalla presentazione e salvata come immagine con un fattore di scala di 2. Ciò consente un’output a risoluzione più alta quando si esporta il paragrafo. I limiti del paragrafo vengono quindi calcolati considerando la scala. La scalatura può essere particolarmente utile quando è necessaria un’immagine più dettagliata, ad esempio per l’uso in materiali stampati di alta qualità.

import aspose.slides as slides
import math
import io
from PIL import Image

image_scale_x = 2
image_scale_y = image_scale_x

with slides.Presentation("sample.pptx") as presentation:
    first_shape = presentation.slides[0].shapes[0]

    # Salva la forma in memoria come bitmap.
    with first_shape.get_image(slides.ShapeThumbnailBounds.SHAPE, image_scale_x, image_scale_y) as shape_image:
        shape_image_stream = io.BytesIO()
        shape_image.save(shape_image_stream, slides.ImageFormat.PNG)

    # Crea un bitmap della forma dalla memoria.
    shape_image_stream.seek(0)
    shape_bitmap = Image.open(shape_image_stream)

    # Calcola i confini del secondo paragrafo.
    second_paragraph = first_shape.text_frame.paragraphs[1]
    paragraph_rectangle = second_paragraph.get_rect()
    paragraph_rectangle.x *= image_scale_x
    paragraph_rectangle.y *= image_scale_y
    paragraph_rectangle.width *= image_scale_x
    paragraph_rectangle.height *= image_scale_y

    # Calcola le coordinate e le dimensioni dell'immagine di output (dimensione minima - 1x1 pixel).
    image_left = math.floor(paragraph_rectangle.x)
    image_top = math.floor(paragraph_rectangle.y)
    image_right = image_left + max(1, math.ceil(paragraph_rectangle.width))
    image_bottom = image_top + max(1, math.ceil(paragraph_rectangle.height))

    # Ritaglia il bitmap della forma per ottenere solo il bitmap del paragrafo.
    paragraph_bitmap = shape_bitmap.crop((image_left, image_top, image_right, image_bottom))

    paragraph_bitmap.save("paragraph.png")

FAQ

Posso disabilitare completamente l’andare a capo all’interno di un TextFrame?

Sì. Usa l’impostazione di wrapping del TextFrame (wrap_text) per disattivare il wrapping in modo che le linee non vengano spezzate ai bordi del riquadro.

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

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

Dove è 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 controllo ortografico per solo una parte di un paragrafo (ad esempio, una parola)?

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

Migliora le tue presentazioni con AutoFit in Python Ottenere i limiti dei paragrafi dalle presentazioni in Python