Gérer les séries de données de diagramme dans les présentations avec JavaScript

Vue d’ensemble

Un diagramme peut stocker ses valeurs tracées dans des cellules du classeur ou directement sous forme de littéraux numériques. Un ChartSeries représente un ensemble de valeurs liées, et chaque ChartDataPoint représente un point de cette série. Les objets ChartCategory fournissent les libellés ou les valeurs de regroupement partagés par les séries. Dans les diagrammes créés avec des données par défaut, les noms de séries, les catégories et les valeurs de points utilisent des objets ChartDataCell du classeur du diagramme.

Pour un diagramme de catégorie typique, le classeur par défaut utilise la ligne 0 pour les noms de séries, la colonne 0 pour les noms de catégories, et les cellules restantes pour les valeurs des séries. Les index de feuille, de ligne et de colonne passés à ChartDataWorkbook.getCell sont basés sur zéro. Cette disposition est utile lorsque vous créez un diagramme avec des données par défaut, mais ne supposez pas qu’elle soit utilisée par chaque diagramme existant. Pour une présentation chargée, inspectez les cellules référencées par les séries, les catégories et les points de données avant de modifier les valeurs du classeur.

Les paramètres du diagramme ont trois portées différentes :

  • Paramètres au niveau de la série, comme ChartSeries.getFormat, qui définissent l’apparence par défaut de tous les points d’une même série.
  • Paramètres au niveau du point de données, comme ChartDataPoint.getFormat, qui remplacent l’apparence de la série pour un point donné.
  • Paramètres de groupe qui s’appliquent aux séries compatibles appartenant au même ChartSeriesGroup. Accédez au groupe via ChartSeries.getParentSeriesGroup lorsque vous devez définir des options telles que le chevauchement ou la largeur de l’écart.

Lorsque aucun remplissage explicite de point ou de série n’est défini, le style et le thème du diagramme déterminent l’apparence automatique. Lorsque des formats de série et de point sont tous deux présents, le format du point a la priorité pour ce point.

série de diagramme PowerPoint

Pour un diagramme à cylindres groupés, voyez comment changer le type de série 3D ou la forme de barre affecte la première série.

Définir les valeurs de série à l’aide de littéraux numériques

Utilisez des littéraux numériques lorsque les valeurs de série proviennent de données ou de calculs d’application et ne nécessitent pas de références à des cellules de feuille. Appelez setDataSourceTypeForValues avec DataSourceType.DoubleLiterals avant d’assigner le résultat de chaque point via getValue avec setAsLiteralDouble.

Le paramètre de collection contrôle le type de source de toutes les valeurs de points de cette série. La méthode getDataSourceType de chaque valeur de point indique le type sélectionné ; modifiez‑le via le paramètre de collection. Avec Worksheet, utilisez getAsCell pour accéder à la cellule référencée. Avec DoubleLiterals, utilisez getAsLiteralDouble ou setAsLiteralDouble pour lire ou écrire le nombre directement.

L’exemple suivant crée un diagramme à colonnes avec des séries et catégories par défaut, puis attribue les valeurs calculées 10, 20, etc. aux points existants de sa première série. Il enregistre la présentation, la rouvre et affiche les valeurs enregistrées.

const aspose = { slides: require("aspose.slides.via.java") };

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.ClusteredColumn, 20, 20, 500, 300);
    const series = chart.getChartData().getSeries().get_Item(0);

    series.getDataPoints().setDataSourceTypeForValues(aspose.slides.DataSourceType.DoubleLiterals);
    for (let i = 0; i < series.getDataPoints().size(); i++) {
        series.getDataPoints().get_Item(i).getValue().setAsLiteralDouble((i + 1) * 10);
    }

    presentation.save("numeric_literals.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

const reopenedPresentation = new aspose.slides.Presentation("numeric_literals.pptx");
try {
    const reopenedSlide = reopenedPresentation.getSlides().get_Item(0);
    const reopenedChart = reopenedSlide.getShapes().get_Item(0);
    const reopenedSeries = reopenedChart.getChartData().getSeries().get_Item(0);
    for (let i = 0; i < reopenedSeries.getDataPoints().size(); i++) {
        const point = reopenedSeries.getDataPoints().get_Item(i);
        console.log(point.getValue().getAsLiteralDouble());
    }
} finally {
    reopenedPresentation.dispose();
}

Le type de source de la valeur du point est distinct de ChartData.getDataSourceType, qui indique la configuration interne ou externe du classeur du diagramme. Utiliser des littéraux numériques ne supprime pas, en soi, le classeur intégré. Dans cet exemple, le classeur reste disponible pour les libellés de catégories, les noms de séries et les autres séries. Voir Classeur du diagramme pour la gestion des classeurs.

Pour les diagrammes à dispersion et à bulles, utilisez setDataSourceTypeForXValues et setDataSourceTypeForYValues afin de choisir les sources pour getXValue et getYValue. Les diagrammes à bulles utilisent également setDataSourceTypeForBubbleSizes pour getBubbleSize. Définissez chaque source applicable sur DoubleLiterals avant d’assigner des nombres via la méthode setAsLiteralDouble de cette valeur.

Définir le chevauchement des séries du diagramme

ChartSeries.getOverlap indique dans quelle mesure les barres ou colonnes se chevauchent dans un diagramme 2D, de –100 à 100 %. Il s’agit d’une projection en lecture seule du paramètre du groupe de séries parent. Utilisez ChartSeriesGroup.setOverlap pour mettre à jour toutes les séries compatibles de ce groupe. Cette option s’applique aux types de diagrammes affichant des barres ou colonnes groupées ; elle n’affecte pas les groupes de séries non liés dans un diagramme combiné.

L’exemple suivant définit le chevauchement pour le groupe contenant la première série :

const aspose = {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

const firstSlideIndex = 0;
const firstSeriesIndex = 0;
const overlapPercent = java.newByte(30);

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(firstSlideIndex);

    // Le nouveau diagramme contient des séries, des catégories et des valeurs d'exemple.
    const chart = slide.getShapes().addChart(aspose.slides.ChartType.ClusteredColumn, 20, 20, 500, 200);

    const series = chart.getChartData().getSeries().get_Item(firstSeriesIndex);
    series.getParentSeriesGroup().setOverlap(overlapPercent);

    presentation.save("series_overlap.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Le résultat :

Chevauchement des séries

Modifier la couleur de remplissage de la série

Utilisez ChartSeries.getFormat pour définir le remplissage par défaut d’une série entière. Si un point possède déjà un remplissage explicite, son paramètre ChartDataPoint.getFormat remplace le remplissage de la série pour ce point.

L’exemple suivant applique un remplissage bleu uni à la première série :

const aspose = {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

const firstSlideIndex = 0;
const firstSeriesIndex = 0;
const solidFillType = java.newByte(aspose.slides.FillType.Solid);
const blueColor = java.getStaticFieldValue("java.awt.Color", "BLUE");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(firstSlideIndex);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.ClusteredColumn, 20, 20, 500, 200);

    const series = chart.getChartData().getSeries().get_Item(firstSeriesIndex);
    series.getFormat().getFill().setFillType(solidFillType);
    series.getFormat().getFill().getSolidFillColor().setColor(blueColor);

    presentation.save("series_color.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Le résultat :

Couleur de la série

Modifier le nom de la série

Le nom d’une série est stocké dans le classeur de données du diagramme et apparaît normalement dans la légende. Dans le classeur par défaut créé pour un diagramme à colonnes groupées, la cellule B1 se situe à la ligne 0, colonne 1 et contient le nom de la première série. Les constantes nommées de l’exemple suivant rendent cette structure explicite :

const aspose = {};
aspose.slides = require("aspose.slides.via.java");

const firstSlideIndex = 0;
const worksheetIndex = 0;
const seriesNameRowIndex = 0;
const firstSeriesColumnIndex = 1;

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(firstSlideIndex);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.ClusteredColumn, 20, 20, 500, 200);

    const workbook = chart.getChartData().getChartDataWorkbook();
    const seriesNameCell = workbook.getCell(worksheetIndex, seriesNameRowIndex, firstSeriesColumnIndex);
    seriesNameCell.setValue("Revenue");

    presentation.save("series_name.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Vous pouvez également mettre à jour la cellule déjà référencée par ChartSeries.getName. Cette approche évite d’assumer une ligne et une colonne précises dans un diagramme existant :

const aspose = {};
aspose.slides = require("aspose.slides.via.java");

const firstSlideIndex = 0;
const firstSeriesIndex = 0;
const firstNameCellIndex = 0;

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(firstSlideIndex);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.ClusteredColumn, 20, 20, 500, 200);

    const series = chart.getChartData().getSeries().get_Item(firstSeriesIndex);
    const seriesNameCell = series.getName().getAsCells().get_Item(firstNameCellIndex);
    seriesNameCell.setValue("Revenue");

    presentation.save("series_name.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Le résultat :

Nom de la série

Créer une série dont le nom provient de plusieurs cellules

Un nom de série composite est utile lorsqu’un nom de produit et une période de reporting sont stockés dans des cellules distinctes du classeur. Par exemple, vous pouvez combiner Product A dans B1 et 2026 dans C1 en un seul nom de série tout en conservant les deux parties liées à leurs cellules sources.

Utilisez ChartDataWorkbook.getCellCollection pour récupérer la plage de noms, puis transmettez cette collection à ChartSeriesCollection.add. Le paramètre skipHiddenCells contrôle l’inclusion des cellules masquées : true les exclut, false les inclut. Cet exemple utilise false pour inclure chaque cellule de la plage de noms.

L’exemple suivant crée une présentation avec une série et deux points de données. Les cellules B1:C1 ne fournissent que le nom de la série ; A2:A3 fournissent les libellés de catégorie, et B2:B3 les valeurs numériques.

const aspose = {};
aspose.slides = require("aspose.slides.via.java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.ClusteredColumn, 50, 50, 620, 180);

    chart.getChartData().getSeries().clear();
    chart.getChartData().getCategories().clear();
    chart.setLegend(true);

    const workbook = chart.getChartData().getChartDataWorkbook();
    workbook.clear(0);

    // Ces deux cellules fournissent le nom de la série.
    workbook.getCell(0, 0, 1, "Product A");
    workbook.getCell(0, 0, 2, "2026");
    const nameCells = workbook.getCellCollection("Sheet1!$B$1:$C$1", false);
    const series = chart.getChartData().getSeries().add(nameCells, aspose.slides.ChartType.ClusteredColumn);

    // Des cellules distinctes fournissent les catégories et les points de données numériques.
    const northCategory = workbook.getCell(0, 1, 0, "North");
    const southCategory = workbook.getCell(0, 2, 0, "South");
    chart.getChartData().getCategories().add(northCategory);
    chart.getChartData().getCategories().add(southCategory);
    const northValue = workbook.getCell(0, 1, 1, 120);
    const southValue = workbook.getCell(0, 2, 1, 150);
    series.getDataPoints().addDataPointForBarSeries(northValue);
    series.getDataPoints().addDataPointForBarSeries(southValue);

    presentation.save("composite_series_name.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Le nom de série résultant est Product A 2026, avec un espace entre les deux valeurs de cellule. La légende l’affiche comme une seule entrée pour les deux colonnes. L’image ci‑dessous illustre le résultat :

Diagramme à colonnes avec valeurs Nord et Sud et le nom de série composite Product A 2026 dans la légende

Obtenir la couleur de remplissage automatique de la série

ChartSeries.getAutomaticSeriesColor renvoie la couleur calculée à partir de l’index de la série et du style du diagramme. C’est la couleur utilisée lorsque le remplissage de la série n’a pas été défini explicitement. L’appel de la méthode lit la couleur calculée ; il ne définit pas de nouveau remplissage.

L’exemple suivant affiche la couleur automatique de chaque série par défaut :

const aspose = {};
aspose.slides = require("aspose.slides.via.java");

const firstSlideIndex = 0;

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(firstSlideIndex);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.ClusteredColumn, 20, 20, 500, 200);

    const seriesCount = chart.getChartData().getSeries().size();
    for (let seriesIndex = 0; seriesIndex < seriesCount; seriesIndex++) {
        const series = chart.getChartData().getSeries().get_Item(seriesIndex);
        const automaticColor = series.getAutomaticSeriesColor();
        const automaticColorText = automaticColor.toString();
        console.log("Series " + seriesIndex + ": " + automaticColorText);
    }
} finally {
    presentation.dispose();
}

Exemple de sortie pour le style de diagramme par défaut :

Series 0: java.awt.Color[r=79,g=129,b=189]
Series 1: java.awt.Color[r=192,g=80,b=77]
Series 2: java.awt.Color[r=155,g=187,b=89]

Les couleurs exactes dépendent du style et du thème du diagramme.

Définir le remplissage inversé pour une série de diagramme

Pour les séries à barres, colonnes et bulles, ChartSeries.setInvertIfNegative peut afficher les valeurs négatives avec un remplissage différent. Définissez le remplissage régulier de la série sur un remplissage uni, activez l’inversion, puis assignez la couleur des valeurs négatives via ChartSeries.getInvertedSolidFillColor. Les nombres négatifs restent inchangés dans le classeur ; seule leur couleur d’affichage change.

L’exemple suivant remplace les données du diagramme par défaut par une série. La ligne 0 de la feuille contient le nom de la série, la colonne 0 les noms de catégories, et la colonne 1 les valeurs :

const aspose = {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

const firstSlideIndex = 0;
const worksheetIndex = 0;
const headerRowIndex = 0;
const categoryColumnIndex = 0;
const firstSeriesColumnIndex = 1;
const firstDataRowIndex = 1;
const solidFillType = java.newByte(aspose.slides.FillType.Solid);
const redColor = java.getStaticFieldValue("java.awt.Color", "RED");

const categoryNames = ["Category 1", "Category 2", "Category 3"];
const seriesValues = [-20, 50, -30];

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(firstSlideIndex);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.ClusteredColumn, 20, 20, 500, 200);
    const chartData = chart.getChartData();
    const workbook = chartData.getChartDataWorkbook();

    chartData.getSeries().clear();
    chartData.getCategories().clear();

    const seriesNameCell = workbook.getCell(worksheetIndex, headerRowIndex, firstSeriesColumnIndex, "Series 1");
    const chartType = chart.getType();
    const series = chartData.getSeries().add(seriesNameCell, chartType);

    for (let categoryIndex = 0; categoryIndex < categoryNames.length; categoryIndex++) {
        const dataRowIndex = firstDataRowIndex + categoryIndex;
        const categoryName = categoryNames[categoryIndex];
        const seriesValue = seriesValues[categoryIndex];

        const categoryCell = workbook.getCell(worksheetIndex, dataRowIndex, categoryColumnIndex, categoryName);
        chartData.getCategories().add(categoryCell);

        const valueCell = workbook.getCell(worksheetIndex, dataRowIndex, firstSeriesColumnIndex, seriesValue);
        series.getDataPoints().addDataPointForBarSeries(valueCell);
    }

    const automaticSeriesColor = series.getAutomaticSeriesColor();
    series.getFormat().getFill().setFillType(solidFillType);
    series.getFormat().getFill().getSolidFillColor().setColor(automaticSeriesColor);
    series.setInvertIfNegative(true);
    series.getInvertedSolidFillColor().setColor(redColor);

    presentation.save("inverted_solid_fill_color.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Le résultat :

Couleur de remplissage plein inversé

Vous pouvez activer l’inversion pour un point à l’aide de ChartDataPoint.setInvertIfNegative. Dans l’exemple suivant, l’inversion est désactivée pour la série et activée uniquement pour le point sélectionné. Le point reçoit également une valeur négative afin que l’effet soit visible :

const aspose = {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

const firstSlideIndex = 0;
const firstSeriesIndex = 0;
const targetDataPointIndex = 2;
const negativeValue = -30;
const solidFillType = java.newByte(aspose.slides.FillType.Solid);
const redColor = java.getStaticFieldValue("java.awt.Color", "RED");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(firstSlideIndex);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.ClusteredColumn, 20, 20, 500, 200);

    const series = chart.getChartData().getSeries().get_Item(firstSeriesIndex);
    const automaticSeriesColor = series.getAutomaticSeriesColor();
    series.getFormat().getFill().setFillType(solidFillType);
    series.getFormat().getFill().getSolidFillColor().setColor(automaticSeriesColor);
    series.getInvertedSolidFillColor().setColor(redColor);
    series.setInvertIfNegative(false);

    const dataPoint = series.getDataPoints().get_Item(targetDataPointIndex);
    dataPoint.getValue().getAsCell().setValue(negativeValue);
    dataPoint.setInvertIfNegative(true);

    presentation.save("data_point_invert_color_if_negative.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Effacer la valeur d’un point de donnée spécifique

Pour rendre un point vide sans supprimer les autres points, définissez sa cellule de classeur sous‑jacent sur null. Dans un diagramme à colonnes, la valeur tracée est accessible via ChartDataPoint.getValue. Le point conserve sa position de catégorie, mais le diagramme traite sa valeur comme vide selon les paramètres de gestion des valeurs vides du diagramme.

L’exemple suivant ne supprime que le deuxième point de la première série :

const aspose = {};
aspose.slides = require("aspose.slides.via.java");

const firstSlideIndex = 0;
const firstSeriesIndex = 0;
const targetDataPointIndex = 1;

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(firstSlideIndex);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.ClusteredColumn, 20, 20, 500, 200);

    const series = chart.getChartData().getSeries().get_Item(firstSeriesIndex);
    const dataPoint = series.getDataPoints().get_Item(targetDataPointIndex);
    dataPoint.getValue().getAsCell().setValue(null);

    presentation.save("clear_data_point_value.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Les diagrammes à dispersion utilisent des cellules X et Y distinctes, et les diagrammes à bulles utilisent également une cellule de taille. Effacez uniquement la cellule qui représente la valeur que vous souhaitez supprimer. N’appellez pas ChartDataPointCollection.clear lorsque vous voulez conserver les autres points, car cette méthode supprime tous les points de la collection.

Contrôler l’affichage des cellules vides

Les cellules masquées contenant des valeurs sont un cas distinct des cellules vides. Pour inclure ou exclure les données des lignes et colonnes masquées d’une feuille, voyez Inclure les données des lignes et colonnes masquées.

Une cellule de classeur vide représente des données manquantes ; une cellule contenant 0 représente une valeur numérique connue. Appelez ChartDataCell.setValue avec null pour rendre une cellule vide. Un zéro numérique reste un zéro quel que soit le paramètre de cellule vide.

Utilisez Chart.setDisplayBlanksAs pour choisir la façon dont le diagramme affiche les cellules vides. Ce paramètre s’applique à l’ensemble du diagramme. Il modifie la façon dont les blancs sont tracés, sans remplir la cellule vide du classeur avec zéro ou une valeur interpolée.

L’exemple auto‑contenu suivant crée un diagramme en courbes avec une série, vide la valeur du jour 3, puis enregistre le même diagramme avec chaque mode. Aucun fichier d’entrée n’est requis. Le ChartDataWorkbook utilise la feuille 0, la colonne 0 pour les libellés de catégories et la colonne 1 pour les valeurs ; la ligne 0 contient le nom de la série. Les données finales sont 10, 20, empty, 30, 40.

const aspose = {};
aspose.slides = require("aspose.slides.via.java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.LineWithMarkers, 40, 40, 640, 400);
    const chartData = chart.getChartData();
    const workbook = chartData.getChartDataWorkbook();

    chartData.getSeries().clear();
    chartData.getCategories().clear();

    const seriesNameCell = workbook.getCell(0, 0, 1, "Measurements");
    const series = chartData.getSeries().add(seriesNameCell, chart.getType());
    const values = [10, 20, 25, 30, 40];

    for (let i = 0; i < values.length; i++) {
        const categoryCell = workbook.getCell(0, i + 1, 0, "Day " + (i + 1));
        chartData.getCategories().add(categoryCell);
        const valueCell = workbook.getCell(0, i + 1, 1, values[i]);
        series.getDataPoints().addDataPointForLineSeries(valueCell);
    }

    // Laisser le jour 3 réellement vide, tout en conservant sa catégorie et son point de données.
    workbook.getCell(0, 3, 1).setValue(null);

    const modes = [aspose.slides.DisplayBlanksAsType.Gap, aspose.slides.DisplayBlanksAsType.Zero, aspose.slides.DisplayBlanksAsType.Span];
    const modeNames = ["Gap", "Zero", "Span"];
    for (let i = 0; i < modes.length; i++) {
        chart.setDisplayBlanksAs(modes[i]);
        presentation.save("empty_cells_" + modeNames[i] + ".pptx", aspose.slides.SaveFormat.Pptx);
    }
} finally {
    presentation.dispose();
}

Chaque fichier de sortie stocke le mode attribué avant l’enregistrement : empty_cells_Gap.pptx, empty_cells_Zero.pptx et empty_cells_Span.pptx. Pour n’enregistrer qu’une version, définissez le mode désiré et enregistrez la présentation une seule fois au lieu d’itérer sur les modes.

La comparaison ci‑dessous montre les mêmes données dans les trois fichiers. Le jour 3 est vide dans le classeur dans chaque cas :

Diagrammes en courbes avec données identiques : Gap interrompt la ligne au jour 3, Zero abaisse la ligne à zéro, et Span relie le jour 2 au jour 4.

L’effet visible dépend du type de diagramme. Un diagramme en courbes rend les trois modes faciles à comparer. Les diagrammes à barres et à colonnes n’ont pas de ligne à connecter à travers une catégorie manquante, ainsi Span ne peut pas produire le segment de connexion illustré ci‑dessus ; une colonne manquante et une colonne de hauteur zéro peuvent également se ressembler. De même, un diagramme à dispersion avec uniquement des marqueurs n’a aucune ligne de connexion. N’attendez pas trois résultats distincts pour chaque type de diagramme ; vérifiez la sortie pour le type que vous utilisez.

Définir la largeur de l’écart des séries

La largeur de l’écart est l’espace entre les groupes de barres ou de colonnes adjacents, exprimé en pourcentage de la largeur de la barre ou de la colonne. Comme le chevauchement, elle appartient au groupe de séries parent plutôt qu’à une seule série. Appelez ChartSeriesGroup.setGapWidth une fois pour le groupe. Une valeur plus grande crée plus d’espace entre les groupes ; une valeur plus petite les rend plus denses.

L’exemple suivant modifie la largeur de l’écart et n’enregistre que la présentation finale :

const aspose = {};
aspose.slides = require("aspose.slides.via.java");

const firstSlideIndex = 0;
const firstSeriesIndex = 0;
const gapWidthPercent = 30;

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(firstSlideIndex);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.StackedColumn, 20, 20, 500, 200);

    const series = chart.getChartData().getSeries().get_Item(firstSeriesIndex);
    series.getParentSeriesGroup().setGapWidth(gapWidthPercent);

    presentation.save("gap_width_30.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Le résultat :

Largeur de l’écart

Afficher ou masquer les lignes de séries

Les lignes de séries relient visuellement les parties liées d’un diagramme. Utilisez ChartSeriesGroup.setSeriesLines pour les afficher ou les masquer dans les diagrammes à barres empilées et les diagrammes « OfPie ». Dans les diagrammes à barres et colonnes empilées bidimensionnels, elles relient les bordures de piles correspondantes entre les catégories. Dans les diagrammes « Pie of Pie » et « Bar of Pie », elles relient le tracé principal au tracé secondaire. Ce paramètre n’est pas un connecteur générique pour d’autres types de diagrammes.

Accédez au groupe via ChartSeries.getParentSeriesGroup. Le paramètre s’applique à chaque série du groupe. ChartSeries.hasSeriesLines est en lecture seule et reflète le paramètre du groupe parent ; appelez le setter du groupe pour le mettre à jour.

L’exemple suivant crée un diagramme PieOfPie avec des données par défaut. Il enregistre le même diagramme avec les lignes de séries activées puis désactivées, produisant deux présentations à comparer.

const aspose = { slides: require("aspose.slides.via.java") };

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const chart = slide.getShapes().addChart(aspose.slides.ChartType.PieOfPie, 50, 50, 600, 400);
    const series = chart.getChartData().getSeries().get_Item(0);
    const seriesGroup = series.getParentSeriesGroup();

    seriesGroup.setSeriesLines(true);
    presentation.save("series_lines_enabled.pptx", aspose.slides.SaveFormat.Pptx);

    seriesGroup.setSeriesLines(false);
    presentation.save("series_lines_disabled.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}
Lignes de séries activées Lignes de séries désactivées
Diagramme Pie of Pie avec lignes de séries activées Diagramme Pie of Pie avec lignes de séries désactivées
Les deux lignes relient le gros secteur au secteur secondaire. Les deux secteurs restent visibles, mais les lignes de connexion sont masquées.

Les lignes de séries diffèrent des lignes de repère d’étiquette de données, qui relient les libellés à leurs points ; des quadrillages, qui marquent des intervalles le long des axes ; et des lignes dans un diagramme en courbes, qui représentent les valeurs de données. Ce paramètre ne contrôle pas ces éléments.

FAQ

Quels types de diagrammes prennent en charge les séries de données ?

Tous les types de diagrammes représentés par l’énumération ChartType utilisent des données de diagramme, mais leurs séries n’ont pas toutes la même structure de valeurs ni les mêmes paramètres. Par exemple, les diagrammes de catégorie utilisent des catégories et des valeurs, les diagrammes à dispersion utilisent les valeurs X et Y, et les diagrammes à bulles ajoutent les tailles de bulles. Utilisez la méthode de création de point de données correspondant au type de série. Les options telles que le chevauchement et la largeur de l’écart ne s’appliquent qu’aux groupes de barres ou de colonnes compatibles.

Qu’est‑ce qu’un groupe de séries de diagramme ?

Un ChartSeriesGroup regroupe des séries compatibles qui partagent des paramètres de tracé au niveau du groupe. Un diagramme combiné peut contenir plusieurs groupes, de sorte que la modification du groupe atteint via une série ne modifie pas forcément toutes les séries du diagramme.

Un diagramme nouvellement créé contient‑il des données par défaut ?

Oui. Par défaut, ShapeCollection.addChart crée des séries, des catégories et des valeurs d’exemple. Vous pouvez modifier ces cellules ou vider les collections de séries et de catégories avant d’ajouter un jeu de données entièrement personnalisé. Une surcharge permet également de créer un diagramme sans données par défaut.

Comment les objets du diagramme sont‑ils liés aux cellules du classeur ?

Les noms de séries, les libellés de catégories et les valeurs des points de données font référence à des cellules d’un ChartDataWorkbook. Modifier une cellule référencée met à jour l’élément de diagramme correspondant. Lorsque vous construisez des données personnalisées, maintenez les lignes de catégories et les lignes de valeurs de séries alignées afin que chaque point soit tracé sous la catégorie prévue.

Comment effacer un point sans supprimer toute la série ?

Définissez la cellule de valeur concernée sur null pour conserver la position de catégorie du point comme point vide. Utilisez ChartDataPointCollection.clear uniquement lorsque vous souhaitez supprimer tous les points de cette série. Si vous supprimez également des catégories, mettez à jour chaque série afin que leurs valeurs restent alignées avec la collection de catégories.

Comment les points vides sont‑ils affichés ?

Le résultat dépend du type de diagramme et du paramètre configuré via Chart.setDisplayBlanksAs. Les diagrammes pris en charge peuvent afficher les blancs comme des espaces, comme des valeurs zéro, ou en reliant les points voisins. Choisissez le paramètre qui correspond à la signification des données manquantes dans votre présentation. Voir Contrôler l’affichage des cellules vides pour un exemple complet et une comparaison visuelle.

Comment les valeurs négatives sont‑elles formatées ?

Pour les séries à barres, colonnes et bulles prises en charge, appelez ChartSeries.setInvertIfNegative et définissez la couleur renvoyée par ChartSeries.getInvertedSolidFillColor. Vous pouvez remplacer le comportement pour un point individuel avec ChartDataPoint.setInvertIfNegative. Ces méthodes affectent le formatage, pas les valeurs numériques stockées.

Quel format l’emporte lorsque la série et le point sont tous deux formatés ?

Le formatage explicite du point de donnée prime pour ce point. Les autres points continuent d’utiliser le format de série explicite ou, lorsque le format de la série n’est pas défini, le style et le thème automatiques du diagramme. Les paramètres de groupe tels que le chevauchement et la largeur de l’écart contrôlent la mise en page et ne sont pas des surcharges de formatage au niveau du point.

Existe‑t‑il une limite au nombre de séries qu’un diagramme peut contenir ?

Aspose.Slides n’impose pas de limite fixe séparée au nombre de séries. En pratique, les contraintes du fichier de présentation, la mémoire disponible, le temps de rendu et la lisibilité du diagramme déterminent une limite utile.

Que faut‑il modifier lorsque les colonnes sont trop proches ou trop éloignées ?

Appelez ChartSeriesGroup.setGapWidth sur le groupe parent de séries approprié. Augmentez la valeur pour élargir l’espace entre les groupes, ou diminuez‑la pour rapprocher les groupes.