Gérer les tableaux de présentation en Python

À propos de cette page

Créer et modifier des tableaux dans des diapositives PowerPoint avec Aspose.Slides pour Python via Java. Découvrez des exemples de code simples pour rationaliser vos flux de travail de tableau.

Introduction

Un tableau dans PowerPoint est un moyen efficace d’afficher des informations. Les informations dans une grille de cellules (organisées en lignes et colonnes) sont simples et faciles à comprendre.

Aspose.Slides fournit la classe Table , la classe Cell et d’autres types pour vous permettre de créer, mettre à jour et gérer des tableaux dans tous les types de présentations.

Create a Table from Scratch

Créez une instance de la classe Presentation .
Obtenez une référence à une diapositive par son indice.
Définissez une liste de largeurs de colonnes.
Définissez une liste de hauteurs de lignes.
Ajoutez un objet Table à la diapositive via la méthode addTable .
Parcourez chaque Cell pour appliquer le formatage aux bordures supérieure, inférieure, droite et gauche.
Fusionnez les deux premières cellules de la première ligne du tableau.
Accédez au TextFrame d’une Cell .
Ajoutez du texte au TextFrame .
Enregistrez la présentation modifiée.

Ce code Python montre comment créer un tableau dans une présentation :

import jpype
import asposeslides

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

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

# Instancie une classe Presentation qui représente un fichier PPTX
presentation = Presentation()
try:

    # Accède à la première diapositive
    slide = presentation.getSlides().get_Item(0)

    # Définit les colonnes avec leurs largeurs et les lignes avec leurs hauteurs
    column_widths = [50, 50, 50]
    row_heights = [50, 30, 30, 30, 30]

    # Ajoute une forme de tableau à la diapositive
    table = slide.getShapes().addTable(100, 50, column_widths, row_heights)

    # Définit le format des bordures pour chaque cellule
    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)

    # Fusionne les cellules 1 et 2 de la ligne 1
    table.mergeCells(table.getRows().get_Item(0).get_Item(0), table.getRows().get_Item(0).get_Item(1), False)

    # Ajoute du texte à la cellule fusionnée
    table.getRows().get_Item(0).get_Item(0).getTextFrame().setText("Merged Cells")

    # Enregistre la présentation sur le disque
    presentation.save("table.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Numbering in a Standard Table

Dans un tableau standard, la numérotation des cellules est simple et basée sur zéro. La première cellule d’un tableau est indexée : 0,0 (colonne 0, ligne 0).

Par exemple, les cellules d’un tableau de 4 colonnes et 4 lignes sont numérotées ainsi :

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

Ce code Python montre comment créer un tableau avec une numérotation de cellules standard :

import jpype
import asposeslides

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

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

# Instancie une classe Presentation qui représente un fichier PPTX
presentation = Presentation()
try:

    # Accède à la première diapositive
    slide = presentation.getSlides().get_Item(0)

    # Définit les colonnes avec leurs largeurs et les lignes avec leurs hauteurs
    column_widths = [70, 70, 70, 70]
    row_heights = [70, 70, 70, 70]

    # Ajoute une forme de tableau à la diapositive
    table = slide.getShapes().addTable(100, 50, column_widths, row_heights)

    # Définit le format des bordures pour chaque cellule
    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)

    # Enregistre la présentation sur le disque
    presentation.save("StandardTables_out.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Access an Existing Table

Créez une instance de la classe Presentation .
Obtenez une référence à la diapositive contenant le tableau via son indice.
Initialise une variable pour un objet Table et affectez‑lui None.
Parcourez tous les objets Shape jusqu’à ce que le tableau soit trouvé.

Si vous pensez que la diapositive que vous traitez ne contient qu’un seul tableau, vous pouvez simplement vérifier toutes les formes qu’elle contient. Lorsqu’une forme est identifiée comme un tableau, vous pouvez l’utiliser comme objet Table. Mais si la diapositive que vous traitez contient plusieurs tableaux, il vaut mieux rechercher le tableau dont vous avez besoin via son getAlternativeText.
Utilisez l’objet Table pour travailler avec le tableau. Dans l’exemple ci‑dessous, nous mettons à jour le texte de la première colonne de la deuxième ligne.
Enregistrez la présentation modifiée.

Ce code Python montre comment accéder à un tableau existant et le manipuler :

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat, Table

# Instancie la classe Presentation qui représente un fichier PPTX
presentation = Presentation("UpdateExistingTable.pptx")
try:

    # Accède à la première diapositive
    slide = presentation.getSlides().get_Item(0)

    # Initialise la référence du tableau.
    table = None

    # Parcourt les formes et définit une référence au tableau trouvé
    for shape in slide.getShapes():
        if isinstance(shape, Table):
            table = shape

            # Définit le texte pour la première colonne de la deuxième ligne
            table.get_Item(0, 1).getTextFrame().setText("New")

    # Enregistre la présentation modifiée sur le disque
    presentation.save("table1_out.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Find the Cell That Owns a Text Frame

Lorsque du code de traitement de texte générique reçoit un TextFrame d’un tableau, utilisez la méthode TextFrame.getParentCell pour récupérer la Cell propriétaire. Pour un cadre texte de cellule de tableau, TextFrame.getParentCell renvoie le propriétaire et TextFrame.getParentShape renvoie None, même si le tableau lui‑même est une forme.

Les coordonnées de la cellule sont disponibles via les méthodes en lecture seule Cell.getFirstColumnIndex et Cell.getFirstRowIndex . TextFrame.getParentCell fournit également une navigation en lecture seule : elle renvoie le propriétaire sans en changer la possession. Vérifiez toujours que la cellule renvoyée n’est pas None avant de l’utiliser.

Pour un exemple complet qui identifie les propriétaires de cellules de tableau et de formes, y compris les formes associées aux nœuds SmartArt, consultez Search and Replace Text .

Align Text in a Table

Créez une instance de la classe Presentation .
Obtenez une référence à une diapositive par son indice.
Ajoutez un objet Table à la diapositive.
Accédez à un objet TextFrame du tableau.
Accédez au Paragraph de l’objet TextFrame .
Alignez le texte verticalement.
Enregistrez la présentation modifiée.

Ce code Python montre comment aligner le texte dans un tableau :

import jpype
import asposeslides

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

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

# Crée une instance de la classe Presentation
presentation = Presentation()
try:

    # Obtient la première diapositive
    slide = presentation.getSlides().get_Item(0)

    # Définit les colonnes avec leurs largeurs et les lignes avec leurs hauteurs
    column_widths = [120, 120, 120, 120]
    row_heights = [100, 100, 100, 100]

    # Ajoute la forme de tableau à la diapositive
    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")

    # Accède au cadre texte
    text_frame = table.get_Item(0, 0).getTextFrame()

    # Accède au premier paragraphe du cadre texte.
    paragraph = text_frame.getParagraphs().get_Item(0)

    # Accède à la première portion du paragraphe.
    portion = paragraph.getPortions().get_Item(0)
    portion.setText("Text here")
    portion.getPortionFormat().getFillFormat().setFillType(FillType.Solid)
    portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK)

    # Aligne le texte verticalement
    cell = table.get_Item(0, 0)
    cell.setTextAnchorType(TextAnchorType.Center)
    cell.setTextVerticalType(TextVerticalType.Vertical270)

    # Enregistre la présentation sur le disque
    presentation.save("Vertical_Align_Text_out.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Set Text Formatting on the Table Level

Créez une instance de la classe Presentation .
Obtenez une référence à une diapositive par son indice.
Accédez à un objet Table depuis la diapositive.
Définissez la hauteur de la police du texte avec setFontHeight .
Définissez l’alignement et la marge droite avec setAlignment et setMarginRight .
Définissez le type de texte vertical avec setTextVerticalType .
Enregistrez la présentation modifiée.

Ce code Python montre comment appliquer vos options de formatage préférées au texte d’un tableau :

import jpype
import asposeslides

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

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

# Crée une instance de la classe Presentation
presentation = Presentation("simpletable.pptx")
try:

    # Supposons que la première forme de la première diapositive soit un tableau
    shape = presentation.getSlides().get_Item(0).getShapes().get_Item(0)
    if isinstance(shape, Table):
        table = shape

        # Définit la hauteur de la police des cellules du tableau
        portion_format = PortionFormat()
        portion_format.setFontHeight(25)
        table.setTextFormat(portion_format)

        # Définit l'alignement du texte des cellules du tableau et la marge droite en un appel
        paragraph_format = ParagraphFormat()
        paragraph_format.setAlignment(TextAlignment.Right)
        paragraph_format.setMarginRight(20)
        table.setTextFormat(paragraph_format)

        # Définit le type de texte vertical des cellules du tableau
        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()

Get Table Style Properties

Aspose.Slides vous permet de récupérer les propriétés de style d’un tableau afin de pouvoir les réutiliser pour un autre tableau ou ailleurs. Ce code Python montre comment obtenir les propriétés de style à partir d’un style prédéfini de tableau :

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)  # modifier le thème de préréglage de style par défaut

    # Obtient le préréglage de style du tableau
    style_preset = table.getStylePreset()
    print("Table style preset: ", style_preset)

    # Applique le préréglage de style récupéré à un autre tableau
    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()

Lock Aspect Ratio of a Table

Le rapport d’aspect d’une forme géométrique est le rapport de ses dimensions dans différents axes. Aspose.Slides fournit la méthode setAspectRatioLocked pour vous permettre de verrouiller le réglage du rapport d’aspect pour les tableaux et autres formes.

Ce code Python montre comment verrouiller le rapport d’aspect d’un tableau :

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())  # inverser
        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

Puis‑je activer la direction de lecture de droite à gauche (RTL) pour un tableau entier et le texte de ses cellules ?

Oui. Le tableau expose une méthode setRightToLeft , et les paragraphes possèdent ParagraphFormat.setRightToLeft. L’utilisation des deux garantit l’ordre RTL correct et le rendu à l’intérieur des cellules.

Comment empêcher les utilisateurs de déplacer ou de redimensionner un tableau dans le fichier final ?

Utilisez les verrous de forme pour désactiver le déplacement, le redimensionnement, la sélection, etc. Ces verrous s’appliquent également aux tableaux.

L’insertion d’une image dans une cellule en tant qu’arrière‑plan est‑elle prise en charge ?

Oui. Vous pouvez définir un picture fill pour une cellule ; l’image couvrira la zone de la cellule selon le mode choisi (étirement ou mosaïque).

Gérer les lignes et colonnes des tableaux PowerPoint avec Python