Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Criar Linha com

valor

Conteúdo

Insere Cria uma linha com valor na célula de uma planilha Excel. Esse valor será inserido apenas na primeira coluna.

Parâmetros

ParâmetroNomeTipoDoc
Parâmetro 1AbaStringRecebe a variável que usamos para criar a aba da planilha
Parâmetro 2Número da LinhaStringRecebe o
valor
número da linha na planilha, começando sempre com o valor zero, ao invés de 1, como é no Excel padrão.
Parâmetro 3ConteúdoStringDetermina qual o
valor
conteúdo será inserido na linha

Compatibilidade

 Servidor

Exemplo 1

A função Executar (Figura 1) contém todos os blocos desde a criação até o salvamento do arquivo.

Assim, ela inicia recebendo na variável "novo" Na função abaixo, o objeto da planilha é criado na variável “novo” com o bloco Criar Arquivo Planilha Excel, em seguida, a variável "planilha1" recebe aba (worksheet) “Aba1“ é inserida no objeto da planilha utilizando o bloco Criar Aba.

Utilizamos o bloco Criar Linha com Conteúdo e no parâmetro Aba inserimos a variável "aba" Sheet, o qual criará a planilha. Após isso, inserimos o bloco Linha com valor e no parâmetro Sheet inserimos a variável "planilha1" que usamos para criar a planilha, em seguida, determinamos no parâmetro parâmetro Número da Linha em que iremos inserir o valor na linha "0" linha 0 (equivalente a linha 1 no Excel) e no parâmetro Valor arrastamos Conteúdo informamos o bloco de texto e escrevemos "NovoValor" que será o valor inserido na linha que definimos (Figura 2). Por último, . Ao final, utilizamos o bloco Salvar Arquivo Excel salva o arquivo na pasta da aplicação e o arquivo pode ser baixado na raiz do projeto.Planilha Excel, passando o objeto criado “novo”, o nome do arquivo da planilha e o endereço onde será salvo.


Image AddedImage Removed

Figura 1 - Bloco Criar Linha com valorConteúdo


A execução da função da figura 1 pode ser vista na figura 2.


Image AddedImage Removed

Figura 2 - Valor inserido na linha criada

Exemplo 2

No exemplo da figura 3, inserimos o bloco  Criar Linha com Conteúdo logo após o bloco Inserir Conteúdo na Célula, passando nos parâmetros Número da Linha e Número da Coluna o valor "0", respectivamente. O resultado disso pode ser observado na figura 4, o conteúdo do bloco Inserir Conteúdo na Célula foi sobrescrito pelo conteúdo do bloco Criar Linha com Conteúdo, a mesma ação ocorreria se os blocos estivessem em posições opostas, mas isso só ocorreu porque passamos o mesmo valor para o parâmetro Número da Linha.


Image Added

Figura 3 - Bloco Criar Linha com Conteúdo sobrescrevendo conteúdo do bloco anterior


Image Added

Figura 4 - Resultado da execução da figura 3

Sobre o bloco

Diferente da manipulação direta de uma célula em um arquivo Excel, as coordenadas das células são apenas numéricas, sendo que a primeira célula se acessa com o valor 0:0 em vez de Ade A:1.

Informações
titleMais sobre

 Consulte a documentação de suporte do Excel para quaisquer dúvidas.


Informações
titleBloco Criar Linha

Uma outra alternativa para o bloco Criar Linha com Conteúdo, é o bloco Criar Linha,