Gestire le tabelle di presentazione in Python

Di cosa tratta questa pagina

Crea e modifica tabelle nelle diapositive PowerPoint con Aspose.Slides per Python tramite Java. Scopri esempi di codice semplici per ottimizzare i flussi di lavoro con le tabelle.

Introduzione

Una tabella in PowerPoint è un modo efficiente per visualizzare informazioni. Le informazioni in una griglia di celle (disposte in righe e colonne) sono semplici e facili da comprendere.

Aspose.Slides fornisce la classe Table, la classe Cell e altri tipi per consentire la creazione, l’aggiornamento e la gestione delle tabelle in tutti i tipi di presentazioni.

Creare una tabella da zero

Creare un’istanza della classe Presentation.
Ottenere un riferimento a una diapositiva mediante il suo indice.
Definire un elenco di larghezze delle colonne.
Definire un elenco di altezze delle righe.
Aggiungere un oggetto Table alla diapositiva tramite il metodo addTable.
Iterare su ogni Cell per applicare la formattazione ai bordi superiore, inferiore, destro e sinistro.
Unire le prime due celle della prima riga della tabella.
Accedere al TextFrame di una Cell.
Aggiungere del testo al TextFrame.
Salvare la presentazione modificata.

Questo codice Python mostra come creare una tabella in una presentazione:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import FillType, Presentation, SaveFormat
from java.awt import Color

# Istanzia una classe Presentation che rappresenta un file PPTX
presentation = Presentation()
try:

    # Accede alla prima diapositiva
    slide = presentation.getSlides().get_Item(0)

    # Definisce colonne con larghezze e righe con altezze
    column_widths = [50, 50, 50]
    row_heights = [50, 30, 30, 30, 30]

    # Aggiunge una forma tabella alla diapositiva
    table = slide.getShapes().addTable(100, 50, column_widths, row_heights)

    # Imposta il formato del bordo per ogni cella
    for row in table.getRows():
        for cell in row:
            cell_format = cell.getCellFormat()
            cell_format.getBorderTop().getFillFormat().setFillType(FillType.Solid)
            cell_format.getBorderTop().getFillFormat().getSolidFillColor().setColor(Color.RED)
            cell_format.getBorderTop().setWidth(5)
            cell_format.getBorderBottom().getFillFormat().setFillType(FillType.Solid)
            cell_format.getBorderBottom().getFillFormat().getSolidFillColor().setColor(Color.RED)
            cell_format.getBorderBottom().setWidth(5)
            cell_format.getBorderLeft().getFillFormat().setFillType(FillType.Solid)
            cell_format.getBorderLeft().getFillFormat().getSolidFillColor().setColor(Color.RED)
            cell_format.getBorderLeft().setWidth(5)
            cell_format.getBorderRight().getFillFormat().setFillType(FillType.Solid)
            cell_format.getBorderRight().getFillFormat().getSolidFillColor().setColor(Color.RED)
            cell_format.getBorderRight().setWidth(5)

    # Unisce le celle 1 e 2 della riga 1
    table.mergeCells(table.getRows().get_Item(0).get_Item(0), table.getRows().get_Item(0).get_Item(1), False)

    # Aggiunge del testo alla cella unita
    table.getRows().get_Item(0).get_Item(0).getTextFrame().setText("Merged Cells")

    # Salva la presentazione su disco
    presentation.save("table.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Numerazione in una tabella standard

In una tabella standard, la numerazione delle celle è semplice e basata su zero. La prima cella di una tabella ha indice 0,0 (colonna 0, riga 0).

Ad esempio, le celle di una tabella con 4 colonne e 4 righe sono numerate in questo modo:

(0, 0)	(1, 0)	(2, 0)	(3, 0)
(0, 1)	(1, 1)	(2, 1)	(3, 1)
(0, 2)	(1, 2)	(2, 2)	(3, 2)
(0, 3)	(1, 3)	(2, 3)	(3, 3)

Questo codice Python mostra come creare una tabella con numerazione di celle standard:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import FillType, Presentation, SaveFormat
from java.awt import Color

# Istanzia una classe Presentation che rappresenta un file PPTX
presentation = Presentation()
try:

    # Accede alla prima diapositiva
    slide = presentation.getSlides().get_Item(0)

    # Definisce colonne con larghezze e righe con altezze
    column_widths = [70, 70, 70, 70]
    row_heights = [70, 70, 70, 70]

    # Aggiunge una forma tabella alla diapositiva
    table = slide.getShapes().addTable(100, 50, column_widths, row_heights)

    # Imposta il formato del bordo per ogni cella
    for row in table.getRows():
        for cell in row:
            cell.getCellFormat().getBorderTop().getFillFormat().setFillType(FillType.Solid)
            cell.getCellFormat().getBorderTop().getFillFormat().getSolidFillColor().setColor(Color.RED)
            cell.getCellFormat().getBorderTop().setWidth(5)
            cell.getCellFormat().getBorderBottom().getFillFormat().setFillType(FillType.Solid)
            cell.getCellFormat().getBorderBottom().getFillFormat().getSolidFillColor().setColor(Color.RED)
            cell.getCellFormat().getBorderBottom().setWidth(5)
            cell.getCellFormat().getBorderLeft().getFillFormat().setFillType(FillType.Solid)
            cell.getCellFormat().getBorderLeft().getFillFormat().getSolidFillColor().setColor(Color.RED)
            cell.getCellFormat().getBorderLeft().setWidth(5)
            cell.getCellFormat().getBorderRight().getFillFormat().setFillType(FillType.Solid)
            cell.getCellFormat().getBorderRight().getFillFormat().getSolidFillColor().setColor(Color.RED)
            cell.getCellFormat().getBorderRight().setWidth(5)

    # Salva la presentazione su disco
    presentation.save("StandardTables_out.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Accedere a una tabella esistente

Creare un’istanza della classe Presentation.
Ottenere un riferimento alla diapositiva che contiene la tabella tramite il suo indice.
Inizializzare una variabile per un oggetto Table e impostarla a None.
Iterare su tutti gli oggetti Shape finché non si trova la tabella.

Se sospetti che la diapositiva in uso contenga una sola tabella, puoi semplicemente controllare tutte le forme contenute. Quando una forma viene identificata come tabella, puoi usarla come oggetto Table. Ma se la diapositiva contiene più tabelle, è preferibile cercare la tabella desiderata tramite il suo getAlternativeText.
Utilizzare l’oggetto Table per lavorare con la tabella. Nell’esempio seguente, aggiorniamo il testo nella prima colonna della seconda riga.
Salvare la presentazione modificata.

Questo codice Python mostra come accedere e lavorare con una tabella esistente:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, Table

# Istanzia la classe Presentation che rappresenta un file PPTX
presentation = Presentation("UpdateExistingTable.pptx")
try:

    # Accede alla prima diapositiva
    slide = presentation.getSlides().get_Item(0)

    # Inizializza il riferimento alla tabella.
    table = None

    # Scorre le forme e imposta un riferimento alla tabella trovata
    for shape in slide.getShapes():
        if isinstance(shape, Table):
            table = shape

            # Imposta il testo per la prima colonna della seconda riga
            table.get_Item(0, 1).getTextFrame().setText("New")

    # Salva la presentazione modificata su disco
    presentation.save("table1_out.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Trovare la cella che possiede un TextFrame

Quando del codice generico di elaborazione testo riceve un TextFrame da una tabella, usa il metodo TextFrame.getParentCell per recuperare la Cell proprietaria. Per un TextFrame di cella di tabella, TextFrame.getParentCell restituisce il proprietario e TextFrame.getParentShape restituisce None, anche se la tabella stessa è una forma.

Le coordinate della cella sono disponibili tramite i metodi di sola lettura Cell.getFirstColumnIndex e Cell.getFirstRowIndex. TextFrame.getParentCell fornisce anche una navigazione di sola lettura: restituisce il proprietario ma non ne cambia la proprietà. Controlla sempre se la cella restituita è None prima di usarla.

Per un esempio completo che identifica i proprietari di celle di tabella e di forme, incluse le forme associate a nodi SmartArt, vedi Search and Replace Text.

Allineare il testo in una tabella

Creare un’istanza della classe Presentation.
Ottenere un riferimento a una diapositiva tramite il suo indice.
Aggiungere un oggetto Table alla diapositiva.
Accedere a un oggetto TextFrame dalla tabella.
Accedere al Paragraph dell’oggetto TextFrame.
Allineare il testo verticalmente.
Salvare la presentazione modificata.

Questo codice Python mostra come allineare il testo in una tabella:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import FillType, Presentation, SaveFormat, TextAnchorType, TextVerticalType
from java.awt import Color

# Crea un'istanza della classe Presentation
presentation = Presentation()
try:

    # Ottiene la prima diapositiva
    slide = presentation.getSlides().get_Item(0)

    # Definisce le colonne con larghezze e le righe con altezze
    column_widths = [120, 120, 120, 120]
    row_heights = [100, 100, 100, 100]

    # Aggiunge la forma tabella alla diapositiva
    table = slide.getShapes().addTable(100, 50, column_widths, row_heights)
    table.get_Item(1, 0).getTextFrame().setText("10")
    table.get_Item(2, 0).getTextFrame().setText("20")
    table.get_Item(3, 0).getTextFrame().setText("30")

    # Accede al TextFrame
    text_frame = table.get_Item(0, 0).getTextFrame()

    # Accede al primo paragrafo nel TextFrame.
    paragraph = text_frame.getParagraphs().get_Item(0)

    # Accede alla prima porzione nel paragrafo.
    portion = paragraph.getPortions().get_Item(0)
    portion.setText("Text here")
    portion.getPortionFormat().getFillFormat().setFillType(FillType.Solid)
    portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK)

    # Allinea il testo verticalmente
    cell = table.get_Item(0, 0)
    cell.setTextAnchorType(TextAnchorType.Center)
    cell.setTextVerticalType(TextVerticalType.Vertical270)

    # Salva la presentazione su disco
    presentation.save("Vertical_Align_Text_out.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Impostare la formattazione del testo a livello di tabella

Creare un’istanza della classe Presentation.
Ottenere un riferimento a una diapositiva tramite il suo indice.
Accedere a un oggetto Table dalla diapositiva.
Impostare l’altezza del carattere del testo con setFontHeight.
Impostare l’allineamento e il margine destro con setAlignment e setMarginRight.
Impostare il tipo di testo verticale con setTextVerticalType.
Salvare la presentazione modificata.

Questo codice Python mostra come applicare le opzioni di formattazione preferite al testo in una tabella:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import ParagraphFormat, PortionFormat, Presentation, SaveFormat, TextAlignment, TextFrameFormat, TextVerticalType, Table

# Crea un'istanza della classe Presentation
presentation = Presentation("simpletable.pptx")
try:

    # Supponiamo che la prima forma nella prima diapositiva sia una tabella
    shape = presentation.getSlides().get_Item(0).getShapes().get_Item(0)
    if isinstance(shape, Table):
        table = shape

        # Imposta l'altezza del carattere delle celle della tabella
        portion_format = PortionFormat()
        portion_format.setFontHeight(25)
        table.setTextFormat(portion_format)

        # Imposta l'allineamento del testo delle celle della tabella e il margine destro in un'unica chiamata
        paragraph_format = ParagraphFormat()
        paragraph_format.setAlignment(TextAlignment.Right)
        paragraph_format.setMarginRight(20)
        table.setTextFormat(paragraph_format)

        # Imposta il tipo di testo verticale delle celle della tabella
        text_frame_format = TextFrameFormat()
        text_frame_format.setTextVerticalType(TextVerticalType.Vertical)
        table.setTextFormat(text_frame_format)
        presentation.save("result.pptx", SaveFormat.Pptx)
    else:
        print("The first shape is not a table.")
finally:
    presentation.dispose()

Ottenere le proprietà di stile della tabella

Aspose.Slides consente di recuperare le proprietà di stile di una tabella in modo da poterle utilizzare per un’altra tabella o altrove. Questo codice Python mostra come ottenere le proprietà di stile da uno stile predefinito di tabella:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, TableStylePreset

presentation = Presentation()
try:
    table = presentation.getSlides().get_Item(0).getShapes().addTable(10, 10, [100, 150], [5, 5, 5])
    table.setStylePreset(TableStylePreset.DarkStyle1)  # cambia il tema predefinito del preset di stile

    # Ottiene il preset di stile della tabella
    style_preset = table.getStylePreset()
    print("Table style preset: ", style_preset)

    # Applica il preset di stile recuperato a un'altra tabella
    another_table = presentation.getSlides().get_Item(0).getShapes().addTable(10, 100, [100, 150], [5, 5, 5])
    another_table.setStylePreset(style_preset)
    presentation.save("table.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Bloccare il rapporto di aspetto di una tabella

Il rapporto di aspetto di una forma geometrica è il rapporto delle sue dimensioni in diverse direzioni. Aspose.Slides fornisce il metodo setAspectRatioLocked per consentire di bloccare l’impostazione del rapporto di aspetto per tabelle e altre forme.

Questo codice Python mostra come bloccare il rapporto di aspetto per una tabella:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, Table

presentation = Presentation("pres.pptx")
try:
    shape = presentation.getSlides().get_Item(0).getShapes().get_Item(0)
    if isinstance(shape, Table):
        table = shape
        print("Lock aspect ratio set: ", table.getGraphicalObjectLock().getAspectRatioLocked())
        table.getGraphicalObjectLock().setAspectRatioLocked(not table.getGraphicalObjectLock().getAspectRatioLocked())  # inverti
        print("Lock aspect ratio set: ", table.getGraphicalObjectLock().getAspectRatioLocked())
        presentation.save("pres-out.pptx", SaveFormat.Pptx)
    else:
        print("The first shape is not a table.")
finally:
    presentation.dispose()

FAQ

Posso abilitare la direzione di lettura da destra a sinistra (RTL) per un’intera tabella e il testo nelle sue celle?

Sì. La tabella espone il metodo setRightToLeft, e i paragrafi hanno ParagraphFormat.setRightToLeft. L’uso di entrambi garantisce l’ordine RTL corretto e il rendering all’interno delle celle.

Come posso impedire agli utenti di spostare o ridimensionare una tabella nel file finale?

Utilizza i blocco forme per disabilitare spostamento, ridimensionamento, selezione, ecc. Questi blocchi si applicano anche alle tabelle.

È supportata l’inserimento di un’immagine all’interno di una cella come sfondo?

Sì. È possibile impostare un picture fill per una cella; l’immagine coprirà l’area della cella secondo la modalità scelta (stretch o tile).

Gestire righe e colonne nelle tabelle PowerPoint usando Python