Criar Linha com
valorConteúdo
InsereCria uma linha com valor na célula de uma planilha Excel. Esse valor será inserido apenas na primeira coluna.
Parâmetros
| Parâmetro | Nome | Tipo | Doc |
|---|---|---|---|
| Parâmetro 1 | Aba | String | Recebe a variável que usamos para criar a aba da planilha |
| Parâmetro 2 | Número da Linha | String | Recebe o |
| 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 3 | Conteúdo | String | Determina qual o |
| conteúdo será inserido na linha |
Servidor
Exemplo 1
A função Inserir (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
ArquivoPlanilha Excel, em seguida, a 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
"planilha1" recebe o bloco Criar Sheet, o qual criará a planilha. Após isso, inserimos o bloco Inserir Valor na Célula e determinamos qual célula iremos inserir o valor com o parâmetro Número da Linha e o parâmetro Número da Coluna, onde inserimos o número "0", após isso, no parâmetro Sheet inserimos a variável "planilha1" que usamos para criar a planilha, em seguida, na variável Valor escrevemos "Exemplo" que será o valor inserido na célula que definimos (Figura 2), por último, o bloco Salvar Arquivo Excel salva o arquivo na pasta da aplicação e o arquivo pode ser baixado na raiz do projeto."aba", em seguida, determinamos no parâmetro Número da Linha que iremos inserir o valor na linha 0 (equivalente a linha 1 no Excel) e no parâmetro Conteúdo informamos o texto "NovoValor". Ao final, utilizamos o bloco Salvar Planilha Excel, passando o objeto criado “novo”, o nome do arquivo da planilha e o endereço onde será salvo.
Figura 1 - Bloco Criar Linha com Conteúdo
A execução da função da figura 1 pode ser vista na figura 2.
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.
Figura 3 - Bloco Criar Linha com Conteúdo sobrescrevendo conteúdo do bloco anterior
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 A:1. Consulte a documentação de suporte do Excel para quaisquer dúvidas.
| Informações | ||
|---|---|---|
| ||
Uma outra alternativa para o bloco Criar Linha com Conteúdo, é o bloco Criar Linha, |