Usando gráficos em Aspose.Words para Java

Introdução ao uso de gráficos em Aspose.Words para Java

Neste tutorial, exploraremos como trabalhar com gráficos usando Aspose.Words for Java. Você aprenderá como criar vários tipos de gráficos, personalizar propriedades de eixos, formatar rótulos de dados e muito mais. Vamos mergulhar!

Criando um gráfico de linhas

Para criar um gráfico de linhas, use o seguinte código:

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.insertChart(ChartType.LINE, 432.0, 252.0);
Chart chart = shape.getChart();
chart.getTitle().setText("Data Labels With Different Number Format");

// Exclua a série gerada padrão.
chart.getSeries().clear();

// Adicionando uma série com dados e rótulos de dados.
ChartSeries series1 = chart.getSeries().add("Aspose Series 1", 
    new String[] { "Category 1", "Category 2", "Category 3" }, 
    new double[] { 2.5, 1.5, 3.5 });

series1.hasDataLabels(true);
series1.getDataLabels().setShowValue(true);
series1.getDataLabels().get(0).getNumberFormat().setFormatCode("\"$\"#,##0.00");
series1.getDataLabels().get(1).getNumberFormat().setFormatCode("dd/mm/yyyy");
series1.getDataLabels().get(2).getNumberFormat().setFormatCode("0.00%");

// Ou vincule o código de formato a uma célula de origem.
series1.getDataLabels().get(2).getNumberFormat().isLinkedToSource(true);

doc.save("Your Directory Path" + "WorkingWithCharts.FormatNumberOfDataLabel.docx");

Criando outros tipos de gráficos

Você pode criar diferentes tipos de gráficos, como coluna, área, bolha, dispersão e muito mais, usando técnicas semelhantes. Aqui está um exemplo de inserção de um gráfico de colunas simples:

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0);
Chart chart = shape.getChart();

// Exclua a série gerada padrão.
chart.getSeries().clear();

// Criando categorias e adicionando dados.
String[] categories = new String[] { "Category 1", "Category 2" };
chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 });
chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 });

doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx");

Personalizando propriedades do eixo

Você pode personalizar as propriedades do eixo, como alterar o tipo de eixo, definir marcas de escala, formatar rótulos e muito mais. Aqui está um exemplo de definição de propriedades do eixo XY:

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.insertChart(ChartType.AREA, 432.0, 252.0);
Chart chart = shape.getChart();

// Limpe a série padrão e adicione seus dados.

ChartAxis xAxis = chart.getAxisX();
ChartAxis yAxis = chart.getAxisY();

// Altere o eixo X para ser uma categoria em vez de data.
xAxis.setCategoryType(AxisCategoryType.CATEGORY);
xAxis.setCrosses(AxisCrosses.CUSTOM);
xAxis.setCrossesAt(3.0); //Medido em unidades de exibição do eixo Y (centenas).
xAxis.setReverseOrder(true);
xAxis.setMajorTickMark(AxisTickMark.CROSS);
xAxis.setMinorTickMark(AxisTickMark.OUTSIDE);
xAxis.setTickLabelOffset(200);

yAxis.setTickLabelPosition(AxisTickLabelPosition.HIGH);
yAxis.setMajorUnit(100.0);
yAxis.setMinorUnit(50.0);
yAxis.getDisplayUnit().setUnit(AxisBuiltInUnit.HUNDREDS);
yAxis.getScaling().setMinimum(new AxisBound(100.0));
yAxis.getScaling().setMaximum(new AxisBound(700.0));

doc.save("Your Directory Path" + "WorkingWithCharts.DefineXYAxisProperties.docx");

Formatando rótulos de dados

Você pode formatar rótulos de dados com diferentes formatos numéricos. Aqui está um exemplo:

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0);
Chart chart = shape.getChart();

// Limpe a série padrão e adicione seus dados.

chart.getAxisY().getNumberFormat().setFormatCode("#,##0");

doc.save("Your Directory Path" + "WorkingWithCharts.NumberFormatForAxis.docx");

Personalizações adicionais de gráficos

Você pode personalizar ainda mais seus gráficos ajustando limites, unidades de intervalo entre rótulos, ocultando eixos do gráfico e muito mais. Explore os trechos de código fornecidos para saber mais sobre essas opções.

Conclusão

Neste tutorial, exploramos como trabalhar com gráficos usando Aspose.Words for Java. Você aprendeu como criar vários tipos de gráficos, personalizar propriedades de eixos, formatar rótulos de dados e muito mais. Aspose.Words for Java fornece ferramentas poderosas para adicionar representações visuais de dados aos seus documentos, aprimorando a maneira como você apresenta as informações.

Perguntas frequentes

Como posso adicionar várias séries a um gráfico?

Você pode adicionar várias séries a um gráfico usando ochart.getSeries().add() método. Certifique-se de especificar o nome da série, categorias e valores de dados.

Como posso formatar etiquetas de dados com formatos numéricos personalizados?

Você pode formatar rótulos de dados acessando oDataLabels propriedades de uma série e definindo o código de formato desejado usandogetNumberFormat().setFormatCode().

Como posso personalizar as propriedades dos eixos em um gráfico?

Você pode personalizar as propriedades do eixo, como tipo, marcas de escala, rótulos e muito mais, acessando oChartAxis propriedades comosetCategoryType(), setCrosses() , esetMajorTickMark().

Como posso criar outros tipos de gráficos, como gráficos de dispersão ou de área?

Você pode criar vários tipos de gráficos especificando o apropriadoChartType ao inserir o gráfico usandobuilder.insertChart(ChartType.TYPE, width, height).

Como posso ocultar um eixo do gráfico?

Você pode ocultar um eixo do gráfico definindo a opçãosetHidden(true) propriedade do eixo.