Personalizzare le barre di errore nei grafici delle presentazioni su Android

Panoramica

Questo articolo spiega come lavorare con le barre di errore nei grafici delle presentazioni utilizzando Aspose.Slides. Mostra come aggiungere barre di errore a una serie di grafico, configurare le impostazioni delle barre di errore X e Y e applicare diversi tipi di valore come fisso, percentuale e personalizzato.

Dimostra inoltre come assegnare valori personalizzati alle barre di errore per punti dati individuali in una serie utilizzando la relativa collezione di punti dati. Inoltre, l’articolo include brevi note su come le barre di errore si comportano durante l’esportazione, la loro compatibilità con marcatori ed etichette dei dati, e dove trovare le classi e gli enum di riferimento dell’API correlati.

Aggiungere barre di errore

Aspose.Slides for Android via Java fornisce un’API semplice per gestire i valori delle barre di errore. Il codice di esempio si applica quando si utilizza un tipo di valore personalizzato. Per specificare un valore, utilizzare la proprietà ErrorBarCustomValues di un punto dati specifico nella collezione DataPoints della serie:

  1. Creare un’istanza della classe Presentation.
  2. Aggiungere un grafico a bolle sulla diapositiva desiderata.
  3. Accedere alla prima serie del grafico e impostare il formato della barra di errore X.
  4. Accedere alla prima serie del grafico e impostare il formato della barra di errore Y.
  5. Impostare i valori e il formato delle barre.
  6. Scrivere la presentazione modificata in un file PPTX.
// Crea un'istanza della classe Presentation
Presentation pres = new Presentation();
try {
    // Creazione di un grafico a bolle
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.Bubble, 50, 50, 400, 300, true);

    // Aggiunta di barre di errore e impostazione del loro formato
    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();

    // Salvataggio della presentazione
    pres.save("ErrorBars.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Aggiungere valori personalizzati per le barre di errore

Aspose.Slides for Android via Java fornisce un’API semplice per gestire i valori personalizzati delle barre di errore. Il codice di esempio si applica quando la proprietà IErrorBarsFormat.ValueType è pari a Custom. Per specificare un valore, utilizzare la proprietà ErrorBarCustomValues di un punto dati specifico nella collezione DataPoints della serie:

  1. Creare un’istanza della classe Presentation.
  2. Aggiungere un grafico a bolle sulla diapositiva desiderata.
  3. Accedere alla prima serie del grafico e impostare il formato della barra di errore X.
  4. Accedere alla prima serie del grafico e impostare il formato della barra di errore Y.
  5. Accedere ai punti dati individuali della serie del grafico e impostare i valori delle barre di errore per ciascun punto dati della serie.
  6. Impostare i valori e il formato delle barre.
  7. Scrivere la presentazione modificata in un file PPTX.
// Crea un'istanza della classe Presentation
Presentation pres = new Presentation();
try {
    // Creazione di un grafico a bolle
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.Bubble, 50, 50, 400, 300, true);

    // Aggiunta di barre di errore personalizzate e impostazione del loro formato
    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);

    // Accesso al punto dati della serie del grafico e impostazione dei valori delle barre di errore per
    // punto individuale
    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);

    // Impostazione delle barre di errore per i punti della serie del grafico
    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);
    }

    // Salvataggio della presentazione
    pres.save("ErrorBarsCustomValues.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

FAQ

Cosa succede alle barre di errore quando si esporta una presentazione in PDF o immagini?

Vengono renderizzate come parte del grafico e preservate durante la conversione insieme al resto della formattazione del grafico, a condizione che la versione o il renderer siano compatibili.

Le barre di errore possono essere combinate con marcatori ed etichette dei dati?

Sì. Le barre di errore sono un elemento separato e sono compatibili con marcatori ed etichette dei dati; se gli elementi si sovrappongono, potrebbe essere necessario regolare la formattazione.

Dove posso trovare l’elenco delle proprietà e delle classi per lavorare con le barre di errore nell’API?

Nella documentazione di riferimento API: la classe ErrorBarsFormat e le classi correlate ErrorBarType e ErrorBarValueType.