Personnaliser les barres d'erreur dans les graphiques de présentation à l'aide de Java

Ajouter des barres d’erreur

Aspose.Slides for Java fournit une API simple pour gérer les valeurs des barres d’erreur. Le code d’exemple s’applique lors de l’utilisation d’un type de valeur personnalisé. Pour spécifier une valeur, utilisez la propriété ErrorBarCustomValues d’un point de données spécifique dans la collection DataPoints de la série :

  1. Créez une instance de la classe Presentation.
  2. Ajoutez un graphique à bulles sur la diapositive souhaitée.
  3. Accédez à la première série du graphique et définissez le format de la barre d’erreur X.
  4. Accédez à la première série du graphique et définissez le format de la barre d’erreur Y.
  5. Définissez les valeurs et le format des barres.
  6. Enregistrez la présentation modifiée dans un fichier PPTX.
// Créer une instance de la classe Presentation
Presentation pres = new Presentation();
try {
    // Créer un graphique à bulles
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.Bubble, 50, 50, 400, 300, true);

    // Ajouter des barres d'erreur et définir leur format
    IErrorBarsFormat errBarX = chart.getChartData().getSeries().get_Item(0).getErrorBarsXFormat();
    IErrorBarsFormat errBarY = chart.getChartData().getSeries().get_Item(0).getErrorBarsYFormat();

    errBarX.isVisible();
    errBarY.isVisible();
    errBarX.setValueType((byte) ErrorBarValueType.Fixed);
    errBarX.setValue(0.1f);
    errBarY.setValueType((byte) ErrorBarValueType.Percentage);
    errBarY.setValue(5);
    errBarX.setType((byte) ErrorBarType.Plus);
    errBarY.getFormat().getLine().setWidth(2.0f);
    errBarX.hasEndCap();

    // Enregistrer la présentation
    pres.save("ErrorBars.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Ajouter des valeurs de barres d’erreur personnalisées

Aspose.Slides for Java fournit une API simple pour gérer les valeurs de barres d’erreur personnalisées. Le code d’exemple s’applique lorsque la propriété IErrorBarsFormat.ValueType est égale à Custom. Pour spécifier une valeur, utilisez la propriété ErrorBarCustomValues d’un point de données spécifique dans la collection DataPoints de la série :

  1. Créez une instance de la classe Presentation.
  2. Ajoutez un graphique à bulles sur la diapositive souhaitée.
  3. Accédez à la première série du graphique et définissez le format de la barre d’erreur X.
  4. Accédez à la première série du graphique et définissez le format de la barre d’erreur Y.
  5. Accédez aux points de données individuels de la série du graphique et définissez les valeurs de la barre d’erreur pour chaque point de données de la série.
  6. Définissez les valeurs et le format des barres.
  7. Enregistrez la présentation modifiée dans un fichier PPTX.
// Créer une instance de la classe Presentation
Presentation pres = new Presentation();
try {
    // Créer un graphique à bulles
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.Bubble, 50, 50, 400, 300, true);

    // Ajouter des barres d'erreur personnalisées et définir leur format
    IChartSeries series = chart.getChartData().getSeries().get_Item(0);
    IErrorBarsFormat errBarX = series.getErrorBarsXFormat();
    IErrorBarsFormat errBarY = series.getErrorBarsYFormat();
    errBarX.isVisible();
    errBarY.isVisible();
    errBarX.setValueType((byte) ErrorBarValueType.Custom);
    errBarY.setValueType((byte) ErrorBarValueType.Custom);

    // Accéder au point de données de la série du graphique et définir les valeurs des barres d'erreur pour
    // le point individuel
    IChartDataPointCollection points = series.getDataPoints();
    points.getDataSourceTypeForErrorBarsCustomValues().setDataSourceTypeForXPlusValues((byte) DataSourceType.DoubleLiterals);
    points.getDataSourceTypeForErrorBarsCustomValues().setDataSourceTypeForXMinusValues((byte) DataSourceType.DoubleLiterals);
    points.getDataSourceTypeForErrorBarsCustomValues().setDataSourceTypeForYPlusValues((byte) DataSourceType.DoubleLiterals);
    points.getDataSourceTypeForErrorBarsCustomValues().setDataSourceTypeForYMinusValues((byte) DataSourceType.DoubleLiterals);

    // Définir les barres d'erreur pour les points de la série du graphique
    for (int i = 0; i < points.size(); i++) {
        points.get_Item(i).getErrorBarsCustomValues().getXMinus().setAsLiteralDouble(i + 1);
        points.get_Item(i).getErrorBarsCustomValues().getXPlus().setAsLiteralDouble(i + 1);
        points.get_Item(i).getErrorBarsCustomValues().getYMinus().setAsLiteralDouble(i + 1);
        points.get_Item(i).getErrorBarsCustomValues().getYPlus().setAsLiteralDouble(i + 1);
    }

    // Enregistrer la présentation
    pres.save("ErrorBarsCustomValues.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

FAQ

Que se passe-t-il avec les barres d’erreur lors de l’exportation d’une présentation vers PDF ou images ?

Elles sont rendues comme partie du graphique et conservées lors de la conversion avec le reste du formatage du graphique, en supposant une version ou un moteur compatible.

Les barres d’erreur peuvent-elles être combinées avec des marqueurs et des étiquettes de données ?

Oui. Les barres d’erreur sont un élément séparé et compatibles avec les marqueurs et les étiquettes de données ; si les éléments se chevauchent, il peut être nécessaire d’ajuster le formatage.

Où puis-je trouver la liste des propriétés et des classes pour travailler avec les barres d’erreur dans l’API ?

Dans la référence de l’API : la classe ErrorBarsFormat et les classes associées ErrorBarType et ErrorBarValueType.