Gérer les cellules de tableau dans les présentations sur Android

Vue d’ensemble

Aspose.Slides vous permet d’accéder aux cellules de tableau et de les modifier dans les présentations PowerPoint. Cet article explique comment identifier les cellules de tableau fusionnées, supprimer les bordures des cellules, gérer la numérotation des cellules après fusion ou division, changer la couleur d’arrière‑plan d’une cellule et ajouter une image à l’intérieur d’une cellule de tableau. Les exemples montrent comment créer ou ouvrir une présentation, obtenir un tableau à partir d’une diapositive, mettre à jour le formatage des cellules via leurs propriétés, puis enregistrer la présentation modifiée au format PPTX.

Aspose.Slides utilise des indices basés sur zéro pour accéder aux cellules de tableau dans l’ordre (colonne, ligne).

Identifier une cellule de tableau fusionnée

L’exemple ouvre une présentation existante et accède à la première forme de la première diapositive en tant que tableau. Il suppose que la diapositive et la forme existent et que la forme est bien un tableau. Il parcourt ensuite toutes les lignes et colonnes et utilise isMergedCell pour identifier les cellules appartenant à des régions fusionnées. Pour chaque correspondance, il imprime les coordonnées de la cellule dans l’ordre ligne;colonne, ainsi que getRowSpan, getColSpan, et les coordonnées de départ de la région, getFirstRowIndex et getFirstColumnIndex.

import com.aspose.slides.*;

Presentation presentation = new Presentation("presentation_with_table.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    ITable table = (ITable) slide.getShapes().get_Item(0);

    int rowCount = table.getRows().size();
    for (int rowIndex = 0; rowIndex < rowCount; rowIndex++)
    {
        int columnCount = table.getColumns().size();
        for (int columnIndex = 0; columnIndex < columnCount; columnIndex++)
        {
            ICell cell = table.get_Item(columnIndex, rowIndex);
            if (cell.isMergedCell())
            {
                System.out.printf("Cell %d;%d belongs to a merged region with RowSpan=%d and ColSpan=%d starting at %d;%d.%n", rowIndex, columnIndex, cell.getRowSpan(), cell.getColSpan(), cell.getFirstRowIndex(), cell.getFirstColumnIndex());
            }
        }
    }
} finally {
    presentation.dispose();
}

Supprimer les bordures des cellules de tableau

Créez une Presentation et ajoutez‑y un tableau sur la première diapositive avec addTable. Les largeurs de colonne, hauteurs de ligne et la position du tableau sont spécifiées en points. L’exemple définit les quatre bordures de chaque cellule sur FillType.NoFill, les rendant invisibles.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    double[] columnWidths = { 50, 50, 50, 50 };
    double[] rowHeights = { 50, 30, 30, 30, 30 };
    ITable table = slide.getShapes().addTable(100, 50, columnWidths, rowHeights);

    for (IRow row : table.getRows())
        for (ICell cell : row)
        {
            cell.getCellFormat().getBorderTop().getFillFormat().setFillType(FillType.NoFill);
            cell.getCellFormat().getBorderBottom().getFillFormat().setFillType(FillType.NoFill);
            cell.getCellFormat().getBorderLeft().getFillFormat().setFillType(FillType.NoFill);
            cell.getCellFormat().getBorderRight().getFillFormat().setFillType(FillType.NoFill);
        }

    presentation.save("table.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Ajouter des bordures diagonales aux cellules

Utilisez getBorderDiagonalDown pour tracer une ligne du coin supérieur gauche au coin inférieur droit, et getBorderDiagonalUp pour tracer une ligne du coin inférieur gauche au coin supérieur droit. Une diagonale peut marquer un en‑tête de coin ; les deux diagonales peuvent former un X pour indiquer qu’une cellule n’est pas applicable.

Chaque diagonale est un ILineFormat. Dans son getFillFormat, utilisez setFillType pour sélectionner FillType.Solid et choisissez une couleur via getSolidFillColor. Définissez la largeur de la ligne en points avec setWidth.

L’exemple crée trois cellules dans une même ligne : une diagonale rouge descendant, une diagonale bleue ascendante, et les deux diagonales. Il laisse les bordures supérieure, inférieure, gauche et droite inchangées.

import com.aspose.slides.*;
import android.graphics.Color;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    double[] columnWidths = { 210, 210, 210 };
    double[] rowHeights = { 160 };
    ITable table = slide.getShapes().addTable(45, 130, columnWidths, rowHeights);

    ILineFormat downwardBorder = table.get_Item(0, 0).getCellFormat().getBorderDiagonalDown();
    downwardBorder.getFillFormat().setFillType(FillType.Solid);
    downwardBorder.getFillFormat().getSolidFillColor().setColor(Color.RED);
    downwardBorder.setWidth(3);

    ILineFormat upwardBorder = table.get_Item(1, 0).getCellFormat().getBorderDiagonalUp();
    upwardBorder.getFillFormat().setFillType(FillType.Solid);
    upwardBorder.getFillFormat().getSolidFillColor().setColor(Color.BLUE);
    upwardBorder.setWidth(5);

    ILineFormat crossDownwardBorder = table.get_Item(2, 0).getCellFormat().getBorderDiagonalDown();
    crossDownwardBorder.getFillFormat().setFillType(FillType.Solid);
    crossDownwardBorder.getFillFormat().getSolidFillColor().setColor(Color.RED);
    crossDownwardBorder.setWidth(3);

    ILineFormat crossUpwardBorder = table.get_Item(2, 0).getCellFormat().getBorderDiagonalUp();
    crossUpwardBorder.getFillFormat().setFillType(FillType.Solid);
    crossUpwardBorder.getFillFormat().getSolidFillColor().setColor(Color.BLUE);
    crossUpwardBorder.setWidth(5);

    presentation.save("diagonal_cell_borders.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Une diagonale est une propriété de formatage, pas une division de cellule. Chaque cellule conserve un seul cadre de texte, accessible via getTextFrame; les zones de part et d’autre d’une diagonale ne peuvent pas être éditées séparément.

Trois cellules de tableau affichant une diagonale rouge du coin supérieur gauche au coin inférieur droit, une diagonale bleue du coin inférieur gauche au coin supérieur droit, et les deux diagonales formant un X.

De gauche à droite : diagonale descendante (rouge, 3 pt), diagonale ascendante (bleue, 5 pt) et les deux diagonales.

Fusionner les cellules d’un tableau

Utilisez mergeCells pour combiner une plage rectangulaire de cellules en une seule cellule. Spécifiez les cellules aux coins supérieur‑gauche et inférieur‑droit de la plage. Le dernier argument détermine si la fusion peut inclure des cellules en dehors de la plage spécifiée ; false garde la fusion à l’intérieur de cette plage.

L’exemple crée un tableau 4 × 4 avec des colonnes et lignes de 70 points, puis fusionne les quatre cellules centrales de (1, 1) à (2, 2). La cellule résultante s’étend sur deux colonnes et deux lignes, tandis que la grille sous‑jacente du tableau reste à quatre colonnes et quatre lignes. Pour accéder au contenu ou au formatage de la cellule fusionnée, utilisez sa position supérieure‑gauche : table.get_Item(1, 1) dans cet exemple. Les autres positions de la plage fusionnée restent partie de la grille du tableau, de sorte que les indices des cellules en dehors de la plage ne changent pas.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    double[] columnWidths = { 70, 70, 70, 70 };
    double[] rowHeights = { 70, 70, 70, 70 };
    ITable table = slide.getShapes().addTable(100, 50, columnWidths, rowHeights);

    table.mergeCells(table.get_Item(1, 1), table.get_Item(2, 2), false);

    presentation.save("merged_cells.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Diviser les cellules d’un tableau

La fusion des cellules dans l’exemple précédent conserve la grille du tableau. Diviser une cellule peut introduire une nouvelle colonne dans la grille et modifier les indices de colonne des cellules situées à sa droite. Aspose.Slides suit le modèle de grille des tableaux de PowerPoint.

Cet exemple crée un tableau 4 × 4 avec des colonnes et lignes de 70 points et appelle splitByWidth sur la cellule (1, 1). La moitié de la largeur de 70 points de la cellule est passée pour créer deux cellules de largeur égale.

Après cette division, les deux moitiés sont accessibles via table.get_Item(1, 1) et table.get_Item(2, 1). La grille du tableau possède maintenant cinq colonnes : les cellules initialement en colonnes 2 et 3 se déplacent respectivement aux colonnes 3 et 4. Les indices de ligne restent inchangés. Utilisez ces indices de colonne mis à jour lors de l’accès aux cellules après la division.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    double[] columnWidths = { 70, 70, 70, 70 };
    double[] rowHeights = { 70, 70, 70, 70 };
    ITable table = slide.getShapes().addTable(100, 50, columnWidths, rowHeights);

    table.get_Item(1, 1).splitByWidth(table.get_Item(1, 1).getWidth() / 2);

    presentation.save("split_cells.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Une cellule non fusionnée de 70 points se divise en deux cellules de 35 points, ajoutant une cinquième colonne de grille et décalant les indices à sa droite.

La division de la largeur affecte la cellule (1, 1), en utilisant des indices zéro‑based (colonne, ligne). Les autres lignes conservent une cellule s’étendant sur les deux nouvelles positions de colonne.

Diviser les cellules fusionnées selon la portée de ligne ou de colonne

Pour préparer des cellules de modèle fusionnées à la population de données, utilisez splitByRowSpan pour diviser le long d’une bordure de ligne existante, ou splitByColSpan pour diviser le long d’une bordure de colonne.

L’argument index compte les lignes dans la partie supérieure ou les colonnes dans la partie gauche de la division ; il est relatif à la région fusionnée :

L’exemple suppose qu’une présentation contient un tableau comme première forme de la première diapositive, avec les cellules (1, 2) et (1, 3) fusionnées verticalement. En partant de la position inférieure, il utilise getFirstColumnIndex et getFirstRowIndex pour localiser l’origine et vérifie les deux étendues. splitByRowSpan(1) sépare alors les lignes 2 et 3 pour les noms de produit. Pour une fusion horizontale de deux colonnes, utilisez splitByColSpan(1) à la place.

import com.aspose.slides.*;

Presentation presentation = new Presentation("table_template.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    ITable table = (ITable) slide.getShapes().get_Item(0);

    ICell selectedCell = table.get_Item(1, 3);
    int firstColumnIndex = selectedCell.getFirstColumnIndex();
    int firstRowIndex = selectedCell.getFirstRowIndex();
    ICell mergedCell = table.get_Item(firstColumnIndex, firstRowIndex);

    if (mergedCell.isMergedCell() && mergedCell.getRowSpan() == 2 && mergedCell.getColSpan() == 1)
    {
        mergedCell.splitByRowSpan(1);

        // Récupérez les cellules résultantes du tableau après la division.
        ICell upperCell = table.get_Item(firstColumnIndex, firstRowIndex);
        ICell lowerCell = table.get_Item(firstColumnIndex, firstRowIndex + 1);
        System.out.println("Upper cell merged: " + upperCell.isMergedCell());
        System.out.println("Lower cell merged: " + lowerCell.isMergedCell());

        upperCell.getTextFrame().setText("Product A");
        lowerCell.getTextFrame().setText("Product B");

        presentation.save("split_template.pptx", SaveFormat.Pptx);
    }
    else
    {
        System.out.println("Select a merged region spanning exactly two rows and one column.");
    }
} finally {
    presentation.dispose();
}

La grille du tableau et les indices des cellules environnantes restent inchangés. Récupérez les cellules résultantes par leurs coordonnées ; ici, les deux possèdent un étendue de 1 et isMergedCell renvoie false. Des régions plus grandes peuvent rester partiellement fusionnées après une division.

Le texte original et son formatage demeurent dans la cellule supérieure (ou gauche) ; la nouvelle cellule est vide mais hérite du formatage de la cellule, tel que le remplissage, les bordures et les marges. Remplissez les cellules après la division et définissez explicitement tout formatage de texte requis.

La présentation enregistrée contient les cellules séparées « Product A » et « Product B » avec le formatage du modèle conservé. Consultez la Cell API Reference pour plus de détails.

Diviser une cellule à une hauteur spécifique

splitByHeight prend la hauteur de la partie supérieure en points. splitByRowSpan prend le nombre de lignes de grille existantes dans la partie supérieure. Pour centrer une cellule de 40 points dans la colonne de droite, soustrayez 40 de la hauteur réelle de la cellule et répartissez l’espace restant également au‑dessus et au‑dessous.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    double[] columnWidths = { 160, 160 };
    double[] rowHeights = { 140 };

    ITable table = slide.getShapes().addTable(50, 50, columnWidths, rowHeights);
    table.get_Item(0, 0).getTextFrame().setText("Left");

    double height = table.get_Item(1, 0).getHeight();
    double margin = (height - 40) / 2;

    table.get_Item(1, 0).splitByHeight(margin);
    table.get_Item(1, 1).splitByHeight(40);
    table.get_Item(1, 1).getTextFrame().setText("Middle");

    presentation.save("split_by_height.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

La première division ajoute une ligne de grille et laisse les 90 points inférieurs dans la cellule (1, 1). La seconde division transforme cette cellule en une cellule centrale de 40 points et une cellule inférieure de 50 points. La colonne de droite comporte maintenant trois cellules avec des hauteurs de 50, 40 et 50 points de haut en bas. La cellule de gauche s’étend sur les trois lignes et conserve sa hauteur originale de 140 points.

La cellule de gauche s’étend sur toute la hauteur du tableau à côté de trois cellules avec le centre au milieu.

Modifier la couleur d’arrière‑plan d’une cellule de tableau

Cet exemple crée un tableau avec des colonnes de 150 points et des lignes de 50 points. Il utilise setFillType pour sélectionner un remplissage plein et définit la couleur renvoyée par getSolidFillColor sur rouge pour la cellule (2, 3), soit la troisième colonne et la quatrième ligne.

import com.aspose.slides.*;
import android.graphics.Color;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    double[] columnWidths = { 150, 150, 150, 150 };
    double[] rowHeights = { 50, 50, 50, 50, 50 };
    ITable table = slide.getShapes().addTable(50, 50, columnWidths, rowHeights);

    ICell cell = table.get_Item(2, 3);
    cell.getCellFormat().getFillFormat().setFillType(FillType.Solid);
    cell.getCellFormat().getFillFormat().getSolidFillColor().setColor(Color.RED);

    presentation.save("cell_background_color.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Ajouter une image à l’intérieur d’une cellule de tableau

Placez l’image d’entrée dans le répertoire de travail avant d’exécuter cet exemple. Elle est chargée avec Images.fromFile et ajoutée à la collection d’images de la présentation via addImage. Elle est ensuite affectée au remplissage d’image de la cellule (0, 0), la première cellule du tableau.

PictureFillMode.Stretch étire l’image pour remplir la cellule, ce qui peut modifier son ratio d’aspect. Les largeurs de colonne et hauteurs de ligne sont exprimées en points. L’image chargée est libérée dans un bloc finally après son ajout à la présentation.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    double[] columnWidths = { 150, 150, 150, 150 };
    double[] rowHeights = { 100, 100, 100, 100, 90 };
    ITable table = slide.getShapes().addTable(50, 50, columnWidths, rowHeights);

    IPPImage ppImage;
    IImage image = Images.fromFile("aspose_logo.jpg");
    try {
        ppImage = presentation.getImages().addImage(image);
    } finally {
        image.dispose();
    }

    table.get_Item(0, 0).getCellFormat().getFillFormat().setFillType(FillType.Picture);
    table.get_Item(0, 0).getCellFormat().getFillFormat().getPictureFillFormat().setPictureFillMode(PictureFillMode.Stretch);
    table.get_Item(0, 0).getCellFormat().getFillFormat().getPictureFillFormat().getPicture().setImage(ppImage);

    presentation.save("table_cell_with_image.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

FAQ

Puis‑je définir des épaisseurs et des styles de ligne différents pour chaque côté d’une même cellule ?

Oui. Les bordures top/bottom/left/right possèdent des propriétés séparées, ce qui permet d’avoir une épaisseur et un style différents pour chaque côté.

Que se passe‑t‑il avec l’image si je modifie la taille de la colonne/ligne après avoir défini une image comme arrière‑plan de la cellule ?

Le comportement dépend du fill mode (stretch/tile). En mode étirement, l’image s’ajuste à la nouvelle taille de la cellule ; en mode mosaïque, les tuiles sont recalculées.

Puis‑je affecter un hyperlien à tout le contenu d’une cellule ?

Hyperlinks sont définis au niveau du texte (portion) à l’intérieur du cadre de texte de la cellule ou au niveau de l’ensemble du tableau/forme. En pratique, vous affectez le lien à une portion ou à tout le texte de la cellule.

Puis‑je définir des polices différentes au sein d’une même cellule ?

Oui. Le cadre de texte d’une cellule prend en charge les portions (segments) avec un formatage indépendant : famille de police, style, taille et couleur.