# Personalizar Barras de Erro em Gráficos de Apresentação no Android

> Aprenda a adicionar e personalizar barras de erro em gráficos com Aspose.Slides for Android via Java — otimize visualizações de dados em apresentações PowerPoint.

Source: https://docs.aspose.com/slides/pt/androidjava/error-bar/
Updated: 2026-06-10

## **Visão Geral**

Este artigo explica como trabalhar com barras de erro em gráficos de apresentação usando Aspose.Slides. Ele mostra como adicionar barras de erro a uma série de gráfico, configurar as configurações de barra de erro X e Y e aplicar diferentes tipos de valor, como fixo, percentual e valores personalizados.

Ele também demonstra como atribuir valores personalizados de barra de erro para pontos de dados individuais em uma série usando a coleção de pontos de dados correspondente. Além disso, o artigo inclui notas breves sobre como as barras de erro se comportam durante a exportação, sua compatibilidade com marcadores e rótulos de dados, e onde encontrar as classes e enums de referência da API relacionados.

## **Adicionar Barras de Erro**
Aspose.Slides for Android via Java fornece uma API simples para gerenciar valores de barras de erro. O código de exemplo se aplica ao usar um tipo de valor personalizado. Para especificar um valor, use a propriedade **ErrorBarCustomValues** de um ponto de dados específico na coleção [**DataPoints**](https://reference.aspose.com/slides/pt/androidjava/com.aspose.slides/IChartSeriesCollection) da série:

1. Crie uma instância da classe [Presentation](https://reference.aspose.com/slides/pt/androidjava/com.aspose.slides/Presentation).
1. Adicione um gráfico de bolhas no slide desejado.
1. Acesse a primeira série de gráfico e defina o formato da barra de erro X.
1. Acesse a primeira série de gráfico e defina o formato da barra de erro Y.
1. Defina os valores e o formato das barras.
1. Grave a apresentação modificada em um arquivo PPTX.

```java
// Criar uma instância da classe Presentation
Presentation pres = new Presentation();
try {
    // Criando um gráfico de bolhas
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.Bubble, 50, 50, 400, 300, true);

    // Adicionando barras de erro e definindo seu 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();

    // Salvando a apresentação
    pres.save("ErrorBars.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}
```

## **Adicionar Valores Personalizados de Barra de Erro**
Aspose.Slides for Android via Java fornece uma API simples para gerenciar valores personalizados de barra de erro. O código de exemplo se aplica quando a propriedade [**IErrorBarsFormat.ValueType**](https://reference.aspose.com/slides/pt/androidjava/com.aspose.slides/IErrorBarsFormat#getValue--) é igual a **Custom**. Para especificar um valor, use a propriedade **ErrorBarCustomValues** de um ponto de dados específico na coleção [**DataPoints**](https://reference.aspose.com/slides/pt/androidjava/com.aspose.slides/IChartSeriesCollection) da série:

1. Crie uma instância da classe [Presentation](https://reference.aspose.com/slides/pt/androidjava/com.aspose.slides/Presentation).
1. Adicione um gráfico de bolhas no slide desejado.
1. Acesse a primeira série de gráfico e defina o formato da barra de erro X.
1. Acesse a primeira série de gráfico e defina o formato da barra de erro Y.
1. Acesse os pontos de dados individuais da série de gráfico e defina os valores da Barra de Erro para cada ponto de dados da série.
1. Defina os valores e o formato das barras.
1. Grave a apresentação modificada em um arquivo PPTX.

```java
// Criar uma instância da classe Presentation
Presentation pres = new Presentation();
try {
    // Criando um gráfico de bolhas
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.Bubble, 50, 50, 400, 300, true);

    // Adicionando barras de erro personalizadas e definindo seu 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);

    // Acessando o ponto de dados da série de gráfico e definindo valores das barras de erro para
    // ponto individual
    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);

    // Definindo barras de erro para os pontos da série de gráfico
    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);
    }

    // Salvando a apresentação
    pres.save("ErrorBarsCustomValues.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}
```

## **FAQ**

**O que acontece com as barras de erro ao exportar uma apresentação para PDF ou imagens?**

Elas são renderizadas como parte do gráfico e preservadas durante a conversão junto com o restante da formatação do gráfico, assumindo uma versão ou renderizador compatível.

**As barras de erro podem ser combinadas com marcadores e rótulos de dados?**

Sim. As barras de erro são um elemento separado e são compatíveis com marcadores e rótulos de dados; se os elementos se sobreporem, pode ser necessário ajustar a formatação.

**Onde posso encontrar a lista de propriedades e classes para trabalhar com barras de erro na API?**

Na referência da API: a classe [ErrorBarsFormat](https://reference.aspose.com/slides/pt/androidjava/com.aspose.slides/errorbarsformat/) e as classes relacionadas [ErrorBarType](https://reference.aspose.com/slides/pt/androidjava/com.aspose.slides/errorbartype/) e [ErrorBarValueType](https://reference.aspose.com/slides/pt/androidjava/com.aspose.slides/errorbarvaluetype/).