Aplicar Fórmulas de Planilha de Gráfico em Apresentações Usando С++

Visão geral

Uma planilha de gráfico é a fonte de dados por trás de um gráfico em uma apresentação. Ela armazena nomes de categorias e séries juntamente com os valores numéricos exibidos pelo gráfico. No Aspose.Slides, essa planilha está disponível através da pasta de trabalho de dados do gráfico, que permite trabalhar com os dados do gráfico programaticamente.

Este artigo explica como usar fórmulas de planilha em dados de gráfico para que os valores das células possam ser calculados e atualizados automaticamente em vez de serem inseridos manualmente. Ele mostra como atribuir fórmulas, usar referências nos estilos A1 e R1C1, recalcular fórmulas da pasta de trabalho e trabalhar com as constantes, operadores, referências de células e funções predefinidas suportadas para planilhas de gráfico em apresentações.

Sobre Fórmulas de Planilha de Gráfico em Apresentações

Planilha de gráfico (ou planilha de dados) em apresentação é a fonte de dados do gráfico. A planilha de gráfico contém dados, que são representados no gráfico de forma gráfica. Quando você cria um gráfico no PowerPoint, a planilha associada a esse gráfico também é criada automaticamente. A planilha de gráfico é criada para todos os tipos de gráficos: gráfico de linhas, gráfico de barras, gráfico Sunburst, gráfico de pizza etc. Para ver a planilha de gráfico no PowerPoint, você deve clicar duas vezes no gráfico:

todo:image_alt_text

A planilha de gráfico contém os nomes dos elementos do gráfico (Nome da Categoria: Category1, Nome da Série) e uma tabela com dados numéricos apropriados a essas categorias e séries. Por padrão, quando você cria um novo gráfico – os dados da planilha de gráfico são definidos com os dados padrão. Em seguida, você pode alterar os dados da planilha manualmente.

Normalmente, o gráfico representa dados complexos (por exemplo, analistas financeiros, analistas científicos), possuindo células que são calculadas a partir dos valores em outras células ou de outros dados dinâmicos. Calcular o valor da célula manualmente e codificá‑lo fixamente na célula dificulta a alteração futura. Se você mudar o valor de uma determinada célula, todas as células dependentes dela precisarão ser atualizadas também. Além disso, os dados da tabela podem depender dos dados de outras tabelas, criando um esquema complexo de dados da apresentação que precisa ser atualizado de forma fácil e flexível.

Fórmula de planilha de gráfico em apresentação é uma expressão para calcular e atualizar automaticamente os dados da planilha de gráfico. A fórmula de planilha define a lógica de cálculo dos dados para uma certa célula ou conjunto de células. A fórmula de planilha é uma fórmula matemática ou lógica, que usa: referências de célula, funções matemáticas, operadores lógicos, operadores aritméticos, funções de conversão, constantes de string etc. A definição da fórmula é escrita em uma célula, e essa célula não contém um valor simples. A fórmula de planilha calcula o valor e o devolve, então esse valor é atribuído à célula. As fórmulas de planilha de gráfico em apresentações são, na prática, as mesmas que as fórmulas do Excel, e há suporte às mesmas funções padrão, operadores e constantes para sua implementação.

Em Aspose.Slides a planilha de gráfico é representada pelo método ChartData::get_ChartDataWorkbook() do tipo IChartDataWorkbook. A fórmula de planilha pode ser atribuída e alterada com o método IChartDataCell::set_Formula(). A funcionalidade a seguir é suportada para fórmulas no Aspose.Slides:

  • Constantes lógicas
  • Constantes numéricas
  • Constantes de string
  • Constantes de erro
  • Operadores aritméticos
  • Operadores de comparação
  • Referências de célula no estilo A1
  • Referências de célula no estilo R1C1
  • Funções predefinidas

Normalmente, as planilhas armazenam os últimos valores calculados das fórmulas. Se, após o carregamento da apresentação, os dados do gráfico não foram alterados – o método IChartDataCell.get_Value() retorna esses valores ao ler. Mas, se os dados da planilha foram alterados, ao ler ChartDataCell.get_Value() o método lança a CellUnsupportedDataException para as fórmulas não suportadas. Isso ocorre porque, quando as fórmulas são analisadas com sucesso, as dependências das células são determinadas e a correção dos últimos valores é verificada. Porém, se a fórmula não puder ser analisada, a correção do valor da célula não pode ser garantida.

Adicionar uma Fórmula de Planilha de Gráfico a uma Apresentação

Primeiro, adicione um gráfico ao primeiro slide de uma nova apresentação com IShapeCollection::AddChart(). A planilha do gráfico é criada automaticamente e pode ser acessada com o método ChartData::get_ChartDataWorkbook():

auto presentation = System::MakeObject<Presentation>();
    
auto chart = presentation->get_Slides()->idx_get(0)->get_Shapes()->AddChart(ChartType::ClusteredColumn, 150.0f, 150.0f, 500.0f, 300.0f);
auto workbook = chart->get_ChartData()->get_ChartDataWorkbook();

// ...

Vamos escrever alguns valores em células com o método IChartDataCell.set_Value() do tipo Object, que significa que você pode passar qualquer valor para o método:

workbook->GetCell(0, u"F2")->set_Value(System::ObjectExt::Box<double>(-2.5));
workbook->GetCell(0, u"G3")->set_Value(System::ObjectExt::Box<double>(6.3));
workbook->GetCell(0, u"H4")->set_Value(System::ObjectExt::Box<int32_t>(3));

Agora, para escrever uma fórmula na célula, você pode usar o método IChartDataCell::set_Formula():

Nota: IChartDataCell::set_Formula() é usado para definir referências de célula no estilo A1.

Para definir a referência de célula R1C1Formula, você pode usar o método IChartDataCell::set_R1C1Formula():

Então, se você ler os valores das células B2 e C2, eles serão calculados:

auto value1 = cell1->get_Value(); // 7.8
auto value2 = cell2->get_Value(); // 2.1

Constantes Lógicas

Você pode usar constantes lógicas como FALSE e TRUE em fórmulas de célula:

Constantes Numéricas

Números podem ser usados em notação comum ou científica para criar fórmulas de planilha de gráfico:

Constantes de String

Uma constante de string (ou literal) é um valor específico que é usado tal como está e não muda. Constantes de string podem ser: datas, textos, números etc.:

Constantes de Erro

Às vezes não é possível calcular o resultado pela fórmula. Nesse caso, o código de erro é exibido na célula em vez de seu valor. Cada tipo de erro tem um código específico:

  • #DIV/0! – a fórmula tenta dividir por zero.
  • #GETTING_DATA – pode ser mostrada em uma célula enquanto seu valor ainda está sendo calculado.
  • #N/A – informação ausente ou indisponível. Algumas razões podem ser: as células usadas na fórmula estão vazias, um caractere de espaço extra, erro de ortografia etc.
  • #NAME? – uma certa célula ou outro objeto de fórmula não pode ser encontrado pelo nome.
  • #NULL! – pode aparecer quando há um erro na fórmula, como: (,) ou um caractere de espaço usado no lugar de dois‑pontos (:).
  • #NUM! – o número na fórmula pode ser inválido, muito longo ou muito pequeno etc.
  • #REF! – referência de célula inválida.
  • #VALUE! – tipo de valor inesperado. Por exemplo, valor de string definido em célula numérica.

Operadores Aritméticos

Você pode usar todos os operadores aritméticos em fórmulas de planilha de gráfico:

Operador Significado Exemplo
+ (sinal de adição) Adição ou sinal positivo unário 2 + 3
- (sinal de subtração) Subtração ou negação 2 - 3
-3
* (asterisco) Multiplicação 2 * 3
/ (barra) Divisão 2 / 3
% (porcentagem) Porcentagem 30%
^ (circunflexo) Exponenciação 2 ^ 3

Nota: Para alterar a ordem de avaliação, coloque entre parênteses a parte da fórmula que deve ser calculada primeiro.

Operadores de Comparação

Você pode comparar os valores das células com os operadores de comparação. Quando dois valores são comparados usando esses operadores, o resultado é um valor lógico TRUE ou FALSE:

Operador Significado Exemplo
= (sinal de igualdade) Igual a A2 = 3
<> (sinal de diferença) Diferente de A2 <> 3
> (sinal maior que) Maior que A2 > 3
>= (sinal maior ou igual a) Maior ou igual a A2 >= 3
< (sinal menor que) Menor que A2 < 3
<= (sinal menor ou igual a) Menor ou igual a A2 <= 3

Referências de Célula no Estilo A1

Referências de célula no estilo A1 são usadas para planilhas, onde a coluna tem um identificador de letra (por exemplo, “A") e a linha tem um identificador numérico (por exemplo, “1"). Referências de célula no estilo A1 podem ser usadas da seguinte maneira:

Referência de célula Exemplo
Absoluto Relativo Mistura
Célula $A$2 A2

A$2

$A2
Linha $2:$2 2:2 -
Coluna $A:$A A:A -
Intervalo $A$2:$C$4 A2:C4

$A$2:C4

A$2:$C4

Aqui está um exemplo de como usar referência de célula no estilo A1 em uma fórmula:

Referências de Célula no Estilo R1C1

Referências de célula no estilo R1C1 são usadas para planilhas, onde tanto a linha quanto a coluna têm identificador numérico. Referências de célula no estilo R1C1 podem ser usadas da seguinte maneira:

Referência de célula Exemplo
Absoluto Relativo Mistura
Célula R2C3 R[2]C[3] R2C[3]
R[2]C3
Linha R2 R[2] -
Coluna C3 C[3] -
Intervalo R2C3:R5C7 R[2]C[3]:R[5]C[7] R2C3:R[5]C[7]
R[2]C3:R5C[7]

Aqui está um exemplo de como usar referência de célula no estilo R1C1 em uma fórmula:

Funções Predefinidas

Existem funções predefinidas que podem ser usadas nas fórmulas para simplificar sua implementação. Essas funções encapsulam as operações mais comumente usadas, como:

  • ABS
  • AVERAGE
  • CEILING
  • CHOOSE
  • CONCAT
  • CONCATENATE
  • DATE (sistema de data 1900)
  • DAYS
  • FIND
  • FINDB
  • IF
  • INDEX (forma de referência)
  • LOOKUP (forma vetorial)
  • MATCH (forma vetorial)
  • MAX
  • SUM
  • VLOOKUP

FAQ

Arquivos Excel externos são suportados como fonte de dados para um gráfico com fórmulas?

Sim. Aspose.Slides suporta pastas de trabalho externas como fonte de dados do gráfico, o que permite usar fórmulas de um XLSX fora da apresentação.

As fórmulas de gráfico podem referenciar planilhas dentro do mesmo workbook pelo nome da planilha?

Sim. As fórmulas seguem o modelo padrão de referência do Excel, portanto você pode referenciar outras planilhas dentro do mesmo workbook ou de um workbook externo. Para referências externas, inclua o caminho e o nome do workbook usando a sintaxe do Excel.

Formatar gráficos de apresentação em C++ Animar Gráficos PowerPoint em C++