Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
Criar Linha com Conteúdo
Cria 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 |
Compatibilidade
Image Added Servidor
Exemplo 1
Na função abaixo, o objeto da planilha é criado na variável “novo” com o bloco Criar Planilha 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 "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.
Image Added
Figura 1 - Bloco Criar Linha com Conteúdo
A execução da função da figura 1 pode ser vista na figura 2.
Image Added
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 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, |