Insere uma fórmula em uma célula de uma planilha Excel.

Figura 1 - Bloco Inserir Fórmula na Célula

Compatibilidade

• Bloco servidor: cronapi.excel.Excel.insertCellFormula()

Retorno

O bloco não possui retorno.

Parâmetros

Número da Linha

Recebe o número da linha da célula na planilha em que será adicionada a fórmula.

• Posição: 1
• Inglês: Number of lines
• Tipo: Texto / String 
• Exemplo: "1"

Número da Coluna

Recebe o número da coluna da célula na planilha em que será adicionada a fórmula.

• Posição: 2
• Inglês: Number of column
• Tipo: Texto / String 
• Exemplo: "0"

Aba

Recebe a referência da aba da planilha.

• Posição: 3
• Inglês: Sheet
• Tipo: Texto / String 
• Exemplo: retorno do bloco Criar Aba

Conteúdo

Determina qual a fórmula será inserida na célula.

• Posição: 4
• Inglês: Content
• Tipo: Texto / String 
• Exemplo: A1+A2

Exemplo

Na função a seguir, iniciamos criando o objeto da planilha, armazenado na variável "planilha". Em seguida, adicionamos uma nova aba ao objeto da planilha usando o bloco Criar Aba, que é armazenada na variável "aba". Para inserir valores nas células, utilizamos dois blocos Inserir Conteúdo na Célula: um para a célula A1 e outro para a célula A2, ambos na aba recém-criada. Em cada um desses blocos, passamos o valor 2 como conteúdo a ser inserido.

Posteriormente, utilizamos o bloco Inserir Fórmula na Célula para realizar a soma dos valores inseridos nas células A1 e A2. A fórmula correspondente é definida no parâmetro "Conteúdo" desse bloco.

Por fim, utilizamos o bloco Salvar Planilha Excel para salvar o objeto planilha atualizado.

Figura 2 - Função responsável por inserir uma fórmula em uma célula

O resultado da execução da função pode ser conferido abaixo.

Figura 2.1 - Resultado de execução da função da figura 2