Optimizar Cálculos de Gráficos para Apresentações em Java

Visão geral

Aspose.Slides fornece APIs para trabalhar com cálculos de gráficos e dados de layout em apresentações. Este artigo mostra como recuperar os valores reais dos elementos do gráfico, incluindo a posição e tamanho reais dos elementos que implementam IActualLayout e os valores reais dos eixos do gráfico. Também explica que esses valores são preenchidos após a validação do layout do gráfico.

Além disso, o artigo demonstra como obter a posição real dos elementos de gráfico pai e como ocultar componentes do gráfico, como o título, eixos, legenda e linhas de grade. Juntos, esses exemplos ajudam a inspecionar as informações de layout do gráfico e controlar a visibilidade dos elementos do gráfico em apresentações do PowerPoint programaticamente.

Calcular valores reais dos elementos do gráfico

Aspose.Slides for Java fornece uma API simples para obter essas propriedades. As propriedades da interface IAxis fornecem informações sobre a posição real do elemento de eixo do gráfico (IAxis.getActualMaxValue, IAxis.getActualMinValue, IAxis.getActualMajorUnit, IAxis.getActualMinorUnit, IAxis.getActualMajorUnitScale, IAxis.getActualMinorUnitScale). É necessário chamar o método IChart.validateChartLayout() previamente para preencher as propriedades com valores reais.

Presentation pres = new Presentation();
try {
    Chart chart = (Chart)pres.getSlides().get_Item(0).getShapes().addChart(ChartType.Area, 100, 100, 500, 350);
    chart.validateChartLayout();
    
    double maxValue = chart.getAxes().getVerticalAxis().getActualMaxValue();
    double minValue = chart.getAxes().getVerticalAxis().getActualMinValue();
    
    double majorUnit = chart.getAxes().getHorizontalAxis().getActualMajorUnit();
    double minorUnit = chart.getAxes().getHorizontalAxis().getActualMinorUnit();
} finally {
    if (pres != null) pres.dispose();
}

Calcular posição real dos elementos de gráfico pai

Aspose.Slides for Java fornece uma API simples para obter essas propriedades. As propriedades da interface IActualLayout fornecem informações sobre a posição real do elemento de gráfico pai (IActualLayout.getActualX, IActualLayout.getActualY, IActualLayout.getActualWidth, IActualLayout.getActualHeight). É necessário chamar o método IChart.validateChartLayout() previamente para preencher as propriedades com valores reais.

Presentation pres = new Presentation();
try {
    Chart chart = (Chart) pres.getSlides().get_Item(0).getShapes().addChart(ChartType.ClusteredColumn, 100, 100, 500, 350);
    chart.validateChartLayout();

    double x = chart.getPlotArea().getActualX();
    double y = chart.getPlotArea().getActualY();
    double w = chart.getPlotArea().getActualWidth();
    double h = chart.getPlotArea().getActualHeight();
} finally {
    if (pres != null) pres.dispose();
}

Ocultar elementos do gráfico

Este tópico ajuda a entender como ocultar informações do gráfico. Usando Aspose.Slides for Java você pode ocultar Título, Eixo Vertical, Eixo Horizontal e Linhas de Grade do gráfico. O exemplo de código abaixo mostra como usar essas propriedades.

Presentation pres = new Presentation();
try {
    ISlide slide = pres.getSlides().get_Item(0);
    IChart chart = slide.getShapes().addChart(ChartType.LineWithMarkers, 140, 118, 320, 370);

    //Ocultando o título do gráfico
    chart.setTitle(false);

    ///Ocultando o eixo de valores
    chart.getAxes().getVerticalAxis().setVisible(false);

    //Visibilidade do eixo de categorias
    chart.getAxes().getHorizontalAxis().setVisible(false);

    //Ocultando a legenda
    chart.setLegend(false);

    //Ocultando linhas de grade principais
    chart.getAxes().getHorizontalAxis().getMajorGridLinesFormat().getLine().getFillFormat().setFillType(FillType.NoFill);

    for (int i = 0; i < chart.getChartData().getSeries().size(); i++)
    {
        chart.getChartData().getSeries().removeAt(i);
    }

    IChartSeries series = chart.getChartData().getSeries().get_Item(0);

    series.getMarker().setSymbol(MarkerStyleType.Circle);
    series.getLabels().getDefaultDataLabelFormat().setShowValue(true);
    series.getLabels().getDefaultDataLabelFormat().setPosition(LegendDataLabelPosition.Top);
    series.getMarker().setSize(15);

    //Definindo a cor da linha da série
    series.getFormat().getLine().getFillFormat().setFillType(FillType.Solid);
    series.getFormat().getLine().getFillFormat().getSolidFillColor().setColor(Color.MAGENTA);
    series.getFormat().getLine().setDashStyle(LineDashStyle.Solid);

    pres.save("HideInformationFromChart.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

FAQ

Os livros de Excel externos funcionam como fonte de dados e como isso afeta o recálculo?

Sim. Um gráfico pode referenciar um livro de trabalho externo: ao conectar ou atualizar a fonte externa, fórmulas e valores são extraídos desse livro, e o gráfico reflete as atualizações durante as operações de abertura/edição. A API permite que você especificar o livro de trabalho externo caminho e gerencie os dados vinculados.

Posso calcular e exibir linhas de tendência sem implementar a regressão eu mesmo?

Sim. As Trendlines (linear, exponencial e outras) são adicionadas e atualizadas pelo Aspose.Slides; seus parâmetros são recalculados a partir dos dados da série automaticamente, portanto você não precisa implementar seus próprios cálculos.

Se uma apresentação tem vários gráficos com links externos, posso controlar qual livro de trabalho cada gráfico usa para valores calculados?

Sim. Cada gráfico pode apontar para seu próprio livro de trabalho externo, ou você pode criar/substituir um livro de trabalho externo por gráfico independentemente dos demais.