Formattare il Testo della Presentazione in Python

Panoramica

Questo articolo mostra come formattare il testo in presentazioni PowerPoint e OpenDocument utilizzando Aspose.Slides per Python via .NET. Copre i colori di sfondo, la trasparenza, la spaziatura dei caratteri, le proprietà dei caratteri, la rotazione, la spaziatura dei paragrafi, il comportamento di autofit, l’ancoraggio del testo, le tabulazioni e le impostazioni della lingua.

Salvo indicazione contraria, gli esempi utilizzano sample.pptx. La prima forma nella sua prima diapositiva è una casella di testo, e il suo primo paragrafo contiene il testo mostrato di seguito. Sia gli indici delle diapositive che delle forme sono basati su zero. Gli esempi che selezionano porzioni in grassetto usano la formattazione efficace, inclusa la formattazione in grassetto ereditata:

Testo di esempio

Per trovare e evidenziare testo letterale o corrispondenze di espressioni regolari, vedere Cerca e sostituisci testo.

Imposta colore di sfondo del testo

Utilizza ParagraphFormat.default_portion_format per impostare il colore di evidenziazione predefinito per un paragrafo, oppure utilizza BasePortionFormat.highlight_color per porzioni di testo individuali.

Il seguente esempio imposta un’evidenziazione grigio chiaro come predefinita per il primo paragrafo. I colori di evidenziazione espliciti sulle singole porzioni hanno precedenza su questa impostazione predefinita:

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

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

    auto_shape = slide.shapes[0]
    paragraph = auto_shape.text_frame.paragraphs[0]

    # Imposta il colore di evidenziazione per l'intero paragrafo.
    paragraph.paragraph_format.default_portion_format.highlight_color.color = draw.Color.light_gray

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

Il risultato:

Il paragrafo grigio

L’esempio di codice seguente dimostra come impostare il colore di sfondo per porzioni di testo con un carattere in grassetto:

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

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

    auto_shape = slide.shapes[0]
    paragraph = auto_shape.text_frame.paragraphs[0]

    for portion in paragraph.portions:
        if portion.portion_format.get_effective().font_bold:
            # Imposta il colore di evidenziazione per la porzione di testo.
            portion.portion_format.highlight_color.color = draw.Color.light_gray

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

Il risultato:

Le porzioni di testo grigie

Allinea paragrafi di testo

Utilizza ParagraphFormat.alignment per impostare l’allineamento del paragrafo all’interno di una cornice di testo. Il valore può essere centrato, allineato a sinistra, allineato a destra, giustificato, ecc.

Il seguente esempio di codice mostra come allineare il paragrafo al centro:

import aspose.slides as slides

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

    auto_shape = slide.shapes[0]
    paragraph = auto_shape.text_frame.paragraphs[0]

    # Imposta l'allineamento del paragrafo al centro.
    paragraph.paragraph_format.alignment = slides.TextAlignment.CENTER

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

Il risultato:

Il paragrafo allineato

Allinea i caratteri all’interno di una riga

Utilizza ParagraphFormat.font_alignment per allineare verticalmente le porzioni di testo di diverse dimensioni di carattere all’interno di una riga. Questa impostazione si applica all’intero paragrafo e controlla l’allineamento all’interno di ciascuna sua riga.

Il seguente esempio indipendente crea quattro caselle di testo etichettate su una diapositiva. Ogni paragrafo contiene lo stesso testo a 18, 36 e 54 punti, con un diverso allineamento del carattere. Utilizza Arial, disabilita autofit e il wrapping, e mantiene le cornici di testo sufficientemente grandi per una singola riga.

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

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

    alignments = [slides.FontAlignment.BASELINE, slides.FontAlignment.TOP, slides.FontAlignment.CENTER, slides.FontAlignment.BOTTOM]
    font_sizes = [18, 36, 54]

    for i, alignment in enumerate(alignments):
        shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 30, 20 + i * 130, 660, 120)
        shape.fill_format.fill_type = slides.FillType.NO_FILL
        shape.line_format.fill_format.fill_type = slides.FillType.NO_FILL

        text_frame = shape.text_frame
        text_frame.text_frame_format.anchoring_type = slides.TextAnchorType.TOP
        text_frame.text_frame_format.autofit_type = slides.TextAutofitType.NONE
        text_frame.text_frame_format.wrap_text = slides.NullableBool.FALSE

        label = text_frame.paragraphs[0]
        label.text = alignment.name.title()
        label.paragraph_format.alignment = slides.TextAlignment.LEFT
        label.paragraph_format.default_portion_format.font_height = 14
        label.paragraph_format.default_portion_format.latin_font = slides.FontData("Arial")
        label.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
        label.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.gray

        paragraph = slides.Paragraph()
        paragraph.paragraph_format.font_alignment = alignment
        paragraph.paragraph_format.alignment = slides.TextAlignment.LEFT
        paragraph.paragraph_format.default_portion_format.latin_font = slides.FontData("Arial")
        paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
        paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black

        for font_size in font_sizes:
            portion = slides.Portion("Ag ")
            portion.portion_format.font_height = font_size
            paragraph.portions.add(portion)

        text_frame.paragraphs.add(paragraph)

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

Il risultato:

Confronto di allineamento del carattere Baseline, Top, Center e Bottom con dimensioni dei caratteri miste

L’allineamento del carattere utilizza le metriche del carattere, quindi i bordi visibili delle singole lettere non sempre si allineano esattamente. L’esempio include sia una lettera maiuscola sia un discendente per mostrare la differenza tra allineamento baseline e bottom. La disponibilità del carattere e la sostituzione, i caratteri usati e la differenza di dimensione influenzano il risultato. Le dimensioni della cornice, i margini, l’interlinea, il wrapping e l’autofit influiscono anch’essi sul layout; utilizzare gli stessi caratteri e impostazioni di layout quando si confrontano le modalità.

Questa impostazione differisce da ParagraphFormat.alignment, che controlla l’allineamento orizzontale del paragrafo, e da TextFrameFormat.anchoring_type, che posiziona il blocco di testo verticalmente all’interno della sua forma. La formattazione apice e pedice tramite BasePortionFormat.escapement sposta le singole porzioni rispetto alla baseline invece di impostare l’allineamento del carattere per le righe del paragrafo.

Imposta trasparenza per il testo

La trasparenza del testo è controllata attraverso il componente alfa del colore assegnato a BasePortionFormat.fill_format. Negli esempi seguenti, alpha = 50 è un valore alfa ARGB su scala 0–255, non una percentuale di trasparenza.

L’esempio di codice seguente mostra come applicare la trasparenza al intero paragrafo:

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

alpha = 50

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

    auto_shape = slide.shapes[0]
    paragraph = auto_shape.text_frame.paragraphs[0]

    # Imposta un riempimento nero semitrasparente per il testo.
    paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.from_argb(alpha, draw.Color.black)

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

Il risultato:

Il paragrafo trasparente

Il seguente esempio di codice mostra come applicare la trasparenza alle porzioni di testo con un carattere in grassetto:

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

alpha = 50

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

    auto_shape = slide.shapes[0]
    paragraph = auto_shape.text_frame.paragraphs[0]

    for portion in paragraph.portions:
        if portion.portion_format.get_effective().font_bold:
            # Imposta la trasparenza della porzione di testo.
            portion.portion_format.fill_format.fill_type = slides.FillType.SOLID
            portion.portion_format.fill_format.solid_fill_color.color = draw.Color.from_argb(alpha, draw.Color.black)

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

Il risultato:

Le porzioni di testo trasparenti

Imposta spaziatura dei caratteri per il testo

Utilizza BasePortionFormat.spacing per ampliare o comprimere la spaziatura tra i caratteri in una casella di testo. Gli esempi aggiungono 3 punti di spaziatura; i valori negativi comprimono il testo.

Il seguente codice Python mostra come espandere la spaziatura dei caratteri nel intero paragrafo:

import aspose.slides as slides

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

    auto_shape = slide.shapes[0]
    paragraph = auto_shape.text_frame.paragraphs[0]

    # Nota: Usa valori negativi per comprimere la spaziatura dei caratteri.
    paragraph.paragraph_format.default_portion_format.spacing = 3  # Espandi la spaziatura dei caratteri.

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

Il risultato:

Spaziatura dei caratteri nel paragrafo

L’esempio di codice seguente mostra come espandere la spaziatura dei caratteri nelle porzioni di testo con un carattere in grassetto:

import aspose.slides as slides

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

    auto_shape = slide.shapes[0]
    paragraph = auto_shape.text_frame.paragraphs[0]

    for portion in paragraph.portions:
        if portion.portion_format.get_effective().font_bold:
            # Nota: Usa valori negativi per comprimere la spaziatura dei caratteri.
            portion.portion_format.spacing = 3  # Espandi la spaziatura dei caratteri.

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

Il risultato:

Spaziatura dei caratteri nelle porzioni di testo

Disabilita il kerning per caratteri specifici

In alcuni casi, il testo renderizzato da Aspose.Slides può apparire leggermente più stretto rispetto allo stesso testo visualizzato in PowerPoint. Ciò può accadere perché PowerPoint può ignorare i dati di kerning per alcuni caratteri, anche quando il carattere contiene informazioni di kerning valide e il kerning è abilitato nelle impostazioni di PowerPoint.

Per rendere l’output più vicino a PowerPoint in questi casi, è possibile disabilitare il kerning per le porzioni di testo che usano il carattere interessato. Imposta BasePortionFormat.kerning_minimal_size a un valore maggiore della dimensione effettiva del carattere. Questo esempio richiede “presentation.pptx” con una casella di testo come prima forma della prima diapositiva. Controlla i nomi dei caratteri efficaci, inclusi i caratteri ereditati, e imposta una soglia di 100 punti per le porzioni che usano Roboto. Questo disabilita il kerning per le porzioni corrispondenti con una dimensione del carattere inferiore a 100 punti:

import aspose.slides as slides

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

    auto_shape = slide.shapes[0]
    target_font = "Roboto"

    for paragraph in auto_shape.text_frame.paragraphs:
        for portion in paragraph.portions:
            text_format = portion.portion_format.get_effective()
            fonts = (text_format.latin_font, text_format.east_asian_font, text_format.complex_script_font)
            uses_target_font = any(font is not None and font.font_name == target_font for font in fonts)

            if uses_target_font:
                portion.portion_format.kerning_minimal_size = 100

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

Per il testo corrispondente al di sotto della soglia, questa impostazione previene il kerning e può aiutare ad avvicinare il rendering di Aspose.Slides a quello visivo di PowerPoint per i caratteri soggetti a questo comportamento specifico di PowerPoint.

Gestisci le proprietà del carattere del testo

Le proprietà del carattere possono essere impostate a livello di paragrafo tramite ParagraphFormat.default_portion_format o su singole porzioni tramite PortionFormat.

Il seguente esempio imposta il carattere predefinito del primo paragrafo a Times New Roman 12 pt con formattazione grassetto, corsivo e sottolineatura puntinata. La formattazione esplicita sulle singole porzioni ha precedenza su queste impostazioni predefinite.

import aspose.slides as slides

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

    auto_shape = slide.shapes[0]
    paragraph = auto_shape.text_frame.paragraphs[0]

    # Imposta le proprietà del carattere per il paragrafo.
    portion_format = paragraph.paragraph_format.default_portion_format
    portion_format.font_height = 12
    portion_format.font_bold = slides.NullableBool.TRUE
    portion_format.font_italic = slides.NullableBool.TRUE
    portion_format.font_underline = slides.TextUnderlineType.DOTTED
    portion_format.latin_font = slides.FontData("Times New Roman")

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

Il risultato:

Le proprietà del carattere per il paragrafo

Il seguente esempio applica Times New Roman 13 pt, formattazione corsiva e sottolineatura puntinata alle porzioni la cui formattazione efficace è in grassetto:

import aspose.slides as slides

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

    auto_shape = slide.shapes[0]
    paragraph = auto_shape.text_frame.paragraphs[0]

    for portion in paragraph.portions:
        if portion.portion_format.get_effective().font_bold:
            # Imposta le proprietà del carattere per la porzione di testo.
            portion.portion_format.font_height = 13
            portion.portion_format.font_italic = slides.NullableBool.TRUE
            portion.portion_format.font_underline = slides.TextUnderlineType.DOTTED
            portion.portion_format.latin_font = slides.FontData("Times New Roman")

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

Il risultato:

Le proprietà del carattere per le porzioni di testo

Controlla la normalizzazione dell’altezza del testo

Utilizza BasePortionFormat.normalise_height quando si riproduce la tipografia di un modello o si indagano differenze nell’altezza dei caratteri. In PowerPoint, abilitare la normalizzazione allunga o comprime verticalmente i singoli caratteri per dare loro un’altezza visibile uniforme all’interno della porzione di testo. Non garantisce altezze di testo uguali tra diversi caratteri.

Imposta la proprietà su NullableBool.TRUE or FALSE per abilitare o disabilitare esplicitamente la normalizzazione. NullableBool.NOT_DEFINED lascia l’impostazione locale non impostata così che la porzione erediti il valore, ad esempio dal default_portion_format del paragrafo. Non equivale a False. Usa PortionFormat.get_effective e leggi IBasePortionFormatEffectiveData.normalise_height per ottenere il valore booleano risolto.

Il seguente esempio indipendente richiede Arial installato. Crea due blocchi di testo contenenti le stesse lettere maiuscole, minuscole, discendenti e caratteri accentati a 54 pt. Entrambi i paragrafi abilitano la normalizzazione per impostazione predefinita. La porzione superiore la disabilita esplicitamente; la porzione inferiore la eredita. Le dimensioni delle cornici, i margini e la spaziatura dei paragrafi sono identici, con wrapping e autofit disabilitati per mantenere il confronto coerente. L’esempio stampa FALSE: False e NOT_DEFINED: True, poi salva “text_height_normalization.pptx”.

import aspose.slides as slides

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

    settings = [slides.NullableBool.FALSE, slides.NullableBool.NOT_DEFINED]

    for i, setting in enumerate(settings):
        shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 30, 60 + i * 200, 660, 150)
        shape.fill_format.fill_type = slides.FillType.NO_FILL
        shape.line_format.fill_format.fill_type = slides.FillType.NO_FILL

        text_frame = shape.text_frame
        text_frame.text = "Hxgjpq ÅÉ 0123"
        text_frame.text_frame_format.autofit_type = slides.TextAutofitType.NONE
        text_frame.text_frame_format.wrap_text = slides.NullableBool.FALSE
        text_frame.text_frame_format.anchoring_type = slides.TextAnchorType.TOP
        text_frame.text_frame_format.margin_top = 0
        text_frame.text_frame_format.margin_left = 0

        paragraph = text_frame.paragraphs[0]
        paragraph.paragraph_format.alignment = slides.TextAlignment.LEFT
        paragraph.paragraph_format.space_before = 0
        paragraph.paragraph_format.space_after = 0
        paragraph.paragraph_format.space_within = 100
        paragraph.paragraph_format.default_portion_format.normalise_height = slides.NullableBool.TRUE

        portion = paragraph.portions[0]
        portion.portion_format.latin_font = slides.FontData("Arial")
        portion.portion_format.font_height = 54
        portion.portion_format.fill_format.fill_type = slides.FillType.SOLID
        portion.portion_format.fill_format.solid_fill_color.color = "black"
        portion.portion_format.normalise_height = setting

        print(f"{setting.name}: {portion.portion_format.get_effective().normalise_height}")

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

Il confronto di seguito è stato esportato dalla presentazione salvata. La riga superiore ha la normalizzazione disabilitata (FALSE); la riga inferiore eredita l’impostazione abilitata (NOT_DEFINED → True). Tenere Arial installato per riprodurre quest’aspetto.

Testo Arial 54 punti con normalizzazione disabilitata sopra e normalizzazione ereditata abilitata sotto

La normalizzazione modifica l’altezza dei caratteri senza cambiare il valore assegnato a font_height, che specifica la dimensione del carattere in punti. space_within controlla l’interlinea, mentre autofit_type controlla come il testo o il suo contenitore si adattano. Queste impostazioni servono a scopi diversi e possono influenzare il layout complessivo in modo indipendente. Per ulteriori informazioni sulla formattazione dei paragrafi e sull’ereditarietà, vedere Gestisci paragrafo.

Applica e rimuovi barrato

Utilizza BasePortionFormat.strikethrough_type su una porzione di testo per visualizzare correzioni, termini annullati o prezzi precedenti senza eliminare il testo originale. Impostalo su TextStrikethroughType.SINGLE or DOUBLE per una o due linee attraverso il testo.

Per rimuovere il barrato, assegna TextStrikethroughType.NONE. Questo disabilita esplicitamente l’effetto, anche se la formattazione circostante specifica il barrato. Al contrario, TextStrikethroughType.NOT_DEFINED lascia l’impostazione locale non definita, consentendo alla porzione di ereditare la formattazione, ad esempio dal paragrafo. Non garantisce che il barrato sia rimosso. Usa PortionFormat.get_effective per leggere la formattazione risultante, inclusi i valori ereditati.

Il seguente esempio indipendente crea tre confronti di prezzo. Ogni paragrafo ha porzioni separate per l’etichetta, il prezzo precedente e il prezzo attuale, quindi solo il prezzo precedente è interessato. La prima riga applica e poi rimuove il barrato; le altre righe mantengono il barrato singolo e doppio. Modificare questa proprietà preserva il testo e le altre sue formattazioni, incluso il prezzo precedente in grassetto.

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

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

    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 620, 220)
    shape.fill_format.fill_type = slides.FillType.NO_FILL
    shape.line_format.fill_format.fill_type = slides.FillType.NO_FILL
    shape.text_frame.paragraphs.clear()

    labels = ["None: ", "Single: ", "Double: "]

    for label in labels:
        paragraph = slides.Paragraph()
        paragraph.paragraph_format.alignment = slides.TextAlignment.LEFT
        paragraph.paragraph_format.space_after = 20

        portion_format = paragraph.paragraph_format.default_portion_format
        portion_format.font_height = 28
        portion_format.latin_font = slides.FontData("Arial")
        portion_format.fill_format.fill_type = slides.FillType.SOLID
        portion_format.fill_format.solid_fill_color.color = draw.Color.black

        paragraph.portions.add(slides.Portion(label))

        previous_price = slides.Portion("$100")
        previous_price.portion_format.font_bold = slides.NullableBool.TRUE
        paragraph.portions.add(previous_price)
        paragraph.portions.add(slides.Portion(" → $80"))

        shape.text_frame.paragraphs.add(paragraph)

    paragraphs = shape.text_frame.paragraphs

    # Applica il barrato, poi rimuovilo esplicitamente dal primo prezzo precedente.
    paragraphs[0].portions[1].portion_format.strikethrough_type = slides.TextStrikethroughType.SINGLE
    paragraphs[0].portions[1].portion_format.strikethrough_type = slides.TextStrikethroughType.NONE

    paragraphs[1].portions[1].portion_format.strikethrough_type = slides.TextStrikethroughType.SINGLE
    paragraphs[2].portions[1].portion_format.strikethrough_type = slides.TextStrikethroughType.DOUBLE

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

Il risultato, dall’alto verso il basso: nessun barrato, barrato singolo e barrato doppio.

Prezzi precedenti senza barrato, con barrato singolo e con barrato doppio

Imposta rotazione del testo

Utilizza TextFrameFormat.text_vertical_type per impostare un orientamento predefinito del testo all’interno di una forma.

Il seguente esempio di codice imposta l’orientamento del testo nella forma su TextVerticalType.VERTICAL270, che ruota il testo di 90 gradi in senso antiorario:

import aspose.slides as slides

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

    auto_shape = slide.shapes[0]

    auto_shape.text_frame.text_frame_format.text_vertical_type = slides.TextVerticalType.VERTICAL270

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

Il risultato:

Rotazione del testo

Imposta rotazione personalizzata per le cornici di testo

Utilizza TextFrameFormat.rotation_angle per impostare un angolo di rotazione personalizzato per un TextFrame.

Il codice seguente ruota la cornice di testo di 3 gradi in senso orario all’interno della forma:

import aspose.slides as slides

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

    auto_shape = slide.shapes[0]

    auto_shape.text_frame.text_frame_format.rotation_angle = 3

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

Il risultato:

Rotazione personalizzata del testo

Imposta spaziatura delle righe dei paragrafi

Aspose.Slides fornisce ParagraphFormat.space_after, ParagraphFormat.space_before, e ParagraphFormat.space_within per controllare la spaziatura dei paragrafi. Queste proprietà sono usate come segue:

  • Usa un valore positivo per specificare la spaziatura delle righe come percentuale dell’altezza della riga.
  • Usa un valore negativo per specificare la spaziatura delle righe in punti.

Il seguente esempio imposta la spaziatura interna del primo paragrafo al 200 % dell’altezza della riga (doppio interlinea):

import aspose.slides as slides

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

    auto_shape = slide.shapes[0]
    paragraph = auto_shape.text_frame.paragraphs[0]

    paragraph.paragraph_format.space_within = 200

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

Il risultato:

Spaziatura delle righe nel paragrafo

Controlla l’interruzione di riga

Le regole di interruzione di riga dei paragrafi sono utili in blocchi di testo stretti e presentazioni che mescolano testo latino e asiatico orientale. Le seguenti proprietà appartengono a ParagraphFormat, quindi si applicano all’intero paragrafo:

  • latin_line_break controlla le regole di interruzione di riga per il latino. In testo misto, modificarla può anche cambiare dove il testo e la punteggiatura asiatica orientale adiacenti vanno a capo.
  • east_asian_line_break controlla le regole di interruzione di riga per l’asiatico orientale, incluse le restrizioni sui caratteri all’inizio e alla fine di una riga.

Queste regole non sostituiscono TextFrameFormat.wrap_text, che abilita il wrapping automatico all’interno di una cornice di testo. Influenzano il layout quando il wrapping avviene; non inseriscono caratteri di interruzione di riga. Un’interruzione di riga esplicita forza una nuova riga all’interno del paragrafo indipendentemente dalla larghezza disponibile.

Il seguente esempio indipendente crea un blocco di testo stretto contenente cinese e latino. Imposta entrambe le proprietà di interruzione di riga esplicitamente e salva “line_breaking.pptx”. Per sperimentare con una delle regole, modifica il valore di quella proprietà mantenendo fisse le altre impostazioni. L’esempio usa Arial 24 pt e SimSun con una larghezza della cornice di 160 pt e margini orizzontali della cornice di testo pari a zero. TextFrameFormat.autofit_type è impostato su TextAutofitType.NONE così che dimensione del testo e dimensioni della cornice rimangano fisse.

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

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

    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 160, 300)
    shape.fill_format.fill_type = slides.FillType.NO_FILL

    text_frame = shape.text_frame
    text_frame.text_frame_format.wrap_text = slides.NullableBool.TRUE
    text_frame.text_frame_format.autofit_type = slides.TextAutofitType.NONE
    text_frame.text_frame_format.margin_left = 0
    text_frame.text_frame_format.margin_right = 0

    paragraph = text_frame.paragraphs[0]
    paragraph.text = "中文排版测试,PowerPoint 中文演示。"

    paragraph_format = paragraph.paragraph_format
    paragraph_format.alignment = slides.TextAlignment.LEFT
    paragraph_format.default_portion_format.font_height = 24
    paragraph_format.default_portion_format.latin_font = slides.FontData("Arial")
    paragraph_format.default_portion_format.east_asian_font = slides.FontData("SimSun")
    paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    paragraph_format.latin_line_break = slides.NullableBool.FALSE
    paragraph_format.east_asian_line_break = slides.NullableBool.TRUE

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

Controlla la punteggiatura sospesa

ParagraphFormat.hanging_punctuation consente alla punteggiatura idonea di estendersi oltre il bordo destro della linea di testo invece di occupare la riga successiva. Si applica all’intero paragrafo ed è diverso da un rientro sospeso.

Il seguente esempio indipendente abilita la punteggiatura sospesa in una cornice di testo larga 100 pt e salva “hanging_punctuation.pptx”. Con Arial 24 pt e margini orizzontali della cornice di testo pari a zero, il punto finale rimane dopo “sentence” ed estende oltre il bordo destro del testo. Imposta la proprietà su NullableBool.FALSE per confrontare: con queste impostazioni, il punto occupa una riga separata. Il wrapping è abilitato e l’autofit è disabilitato per mantenere fissa la larghezza disponibile.

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

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

    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 100, 200)
    shape.fill_format.fill_type = slides.FillType.NO_FILL

    text_frame = shape.text_frame
    text_frame.text_frame_format.wrap_text = slides.NullableBool.TRUE
    text_frame.text_frame_format.autofit_type = slides.TextAutofitType.NONE
    text_frame.text_frame_format.margin_left = 0
    text_frame.text_frame_format.margin_right = 0

    paragraph = text_frame.paragraphs[0]
    paragraph.text = "Simple text, next sentence."

    paragraph_format = paragraph.paragraph_format
    paragraph_format.alignment = slides.TextAlignment.LEFT
    paragraph_format.default_portion_format.font_height = 24
    paragraph_format.default_portion_format.latin_font = slides.FontData("Arial")
    paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    paragraph_format.hanging_punctuation = slides.NullableBool.TRUE

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

Non tutti i segni di punteggiatura possono sospendersi. Il risultato visibile dipende da condizioni di carattere e layout: cambiare il carattere, la larghezza disponibile, i margini o le impostazioni di autofit può rimuovere la differenza visibile.

Imposta tipo di autofit per le cornici di testo

TextFrameFormat.autofit_type determina come il testo si comporta quando supera i confini del suo contenitore. Usalo per controllare se il testo si riduce, trabocca o ridimensiona automaticamente la forma. Il seguente esempio configura la forma per ridimensionarsi in base al suo testo e salva il risultato in “autofit_type.pptx”.

import aspose.slides as slides

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

    auto_shape = slide.shapes[0]

    auto_shape.text_frame.text_frame_format.autofit_type = slides.TextAutofitType.SHAPE

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

Per contare le righe dopo il wrapping automatico e vedere come la larghezza del testo o della forma cambia il risultato, vedere Conta le righe renderizzate. Il conteggio delle righe da solo non indica se il testo trabocca dal contenitore.

Imposta ancoraggio delle cornici di testo

TextFrameFormat.anchoring_type definisce come il testo è posizionato verticalmente all’interno di una forma, ad esempio in alto, al centro o in basso. Il seguente esempio ancora il testo al fondo della prima forma e salva il risultato in “text_anchor.pptx”.

import aspose.slides as slides

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

    auto_shape = slide.shapes[0]

    auto_shape.text_frame.text_frame_format.anchoring_type = slides.TextAnchorType.BOTTOM

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

Imposta tabulazione del testo

Utilizza ParagraphFormat.default_tab_size e ParagraphFormat.tabs per configurare le tabulazioni in un paragrafo. Il seguente esempio imposta l’intervallo di tabulazione predefinito a 100 punti e aggiunge una tabulazione allineata a sinistra a 30 punti. Queste impostazioni influenzano il testo contenente caratteri di tabulazione.

import aspose.slides as slides

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

    auto_shape = slide.shapes[0]
    paragraph = auto_shape.text_frame.paragraphs[0]

    paragraph.paragraph_format.default_tab_size = 100
    paragraph.paragraph_format.tabs.add(30, slides.TabAlignment.LEFT)

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

Il risultato:

Le tabulazioni del paragrafo

Imposta lingua di correzione

Aspose.Slides fornisce BasePortionFormat.language_id, che consente di impostare la lingua di correzione per una porzione di testo. La lingua di correzione determina la lingua usata per il controllo ortografico e grammaticale in PowerPoint.

Il seguente esempio richiede “presentation.pptx” con una casella di testo come prima forma della prima diapositiva e almeno un paragrafo. Sostituisce il contenuto del primo paragrafo con “1。”, imposta SimSun come carattere e assegna la lingua di correzione cinese semplificata (zh-CN). Salva il risultato in “proofing_language.pptx”:

import aspose.slides as slides

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

    auto_shape = slide.shapes[0]

    paragraph = auto_shape.text_frame.paragraphs[0]
    paragraph.portions.clear()

    font = slides.FontData("SimSun")

    text_portion = slides.Portion()
    text_portion.portion_format.complex_script_font = font
    text_portion.portion_format.east_asian_font = font
    text_portion.portion_format.latin_font = font

    # Imposta la lingua di correzione a cinese semplificato.
    text_portion.portion_format.language_id = "zh-CN"

    text_portion.text = "1。"
    paragraph.portions.add(text_portion)

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

Imposta lingua predefinita

Utilizza LoadOptions.default_text_language per definire la lingua predefinita per il testo creato durante il caricamento o la creazione di una presentazione. Il seguente esempio crea una presentazione con l’inglese americano come lingua di testo predefinita, aggiunge una casella di testo e stampa en-US per la sua prima porzione di testo.

import aspose.slides as slides

load_options = slides.LoadOptions()
load_options.default_text_language = "en-US"

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

    # Aggiungi una nuova forma rettangolare con testo.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 20, 20, 150, 50)
    shape.text_frame.text = "Sample text"

    # Verifica la lingua della prima porzione.
    portion = shape.text_frame.paragraphs[0].portions[0]
    print(portion.portion_format.language_id)

Imposta stile di testo predefinito

Per applicare la formattazione di testo predefinita a livello di presentazione, utilizza Presentation.default_text_style.

Il seguente esempio imposta un carattere in grassetto da 14 pt come predefinito per i paragrafi di livello superiore in una nuova presentazione e lo salva in “default_text_style.pptx”. Il testo può ereditare questi valori predefiniti a meno che una formattazione più specifica non li sovrascriva.

import aspose.slides as slides

with slides.Presentation() as presentation:
    # Recupera il formato del paragrafo di livello superiore.
    paragraph_format = presentation.default_text_style.get_level(0)

    if paragraph_format is not None:
        paragraph_format.default_portion_format.font_height = 14
        paragraph_format.default_portion_format.font_bold = slides.NullableBool.TRUE

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

Estrai testo con l’effetto tutto maiuscolo

In PowerPoint, applicare l’effetto All Caps al carattere fa apparire il testo in maiuscolo sulla diapositiva anche se era stato digitato originariamente in minuscolo. Quando si recupera tale porzione di testo con Aspose.Slides, la libreria restituisce il testo esattamente come è stato inserito. Per adattarlo al testo visualizzato, controlla TextCapType e converti la stringa restituita in maiuscolo quando il valore è ALL.

Questo esempio richiede “sample2.pptx” con una casella di testo come prima forma della prima diapositiva. La sua prima porzione del primo paragrafo contiene “Hello, Aspose!” con l’effetto All Caps applicato, come mostrato sotto.

L’effetto Tutto Maiuscolo

Il codice seguente mostra come estrarre il testo con l’effetto All Caps applicato:

import aspose.slides as slides

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

    auto_shape = slide.shapes[0]
    text_portion = auto_shape.text_frame.paragraphs[0].portions[0]

    print("Original text:", text_portion.text)

    text_format = text_portion.portion_format.get_effective()
    if text_format.text_cap_type == slides.TextCapType.ALL:
        text = text_portion.text.upper()
        print("All-Caps effect:", text)

Output:

Original text: Hello, Aspose!
All-Caps effect: HELLO, ASPOSE!

FAQ

Come modifico il testo in una tabella su una diapositiva?

Per modificare il testo in una tabella su una diapositiva, utilizza Table. Itera attraverso le celle e aggiorna ciascuna cella tramite Cell.text_frame e la formattazione del paragrafo tramite Paragraph.paragraph_format.

Come applico un colore a gradiente al testo su una diapositiva PowerPoint?

Per applicare un colore a gradiente al testo, utilizza BasePortionFormat.fill_format. Imposta FillFormat.fill_type su FillType.GRADIENT e configura le fermate del gradiente, la direzione e la trasparenza.

Feature correlata: Formato del testo nelle diapositive.