Criar Linha
Cria uma linha em uma planilha Excel.
Por padrão, abas recém criadas a partir do bloco Criar Aba não possuem linhas ou colunas, dessa forma, para manipular a planilha é necessário que existam linhas que podem ser criadas a partir do bloco Criar Linha ou através de outros blocos já possuem esse recurso, como é o caso do bloco Inserir Conteúdo na Célula ou Criar Linha com Conteúdo.
Parâmetros
| Parâmetro | Nome | Tipo | Doc |
|---|---|---|---|
| Parâmetro 1 | 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 2 | Aba | String | Recebe a variável correspondente à aba da planilha Excel. |
Servidor
Exemplo
Na função abaixo, o objeto da planilha é criado na variável “novo”, a aba (worksheet) “Aba1“ é inserida no objeto da planilha utilizando o bloco Criar Aba. O primeiro bloco Inserir Conteúdo na Célula cria a primeira linha e automaticamente insere um texto na célula "0:0", equivalente a "A1" no Excel.
No bloco Criar linha, passamos no parâmetro Número da linha, a linha já criada pelo primeiro bloco Inserir Conteúdo na Célula e no parâmetro Aba informamos a variável "aba. O objetivo desse bloco neste exemplo é demonstrar que, ao criar uma linha em cima de uma linha que já exista na planilha, seu conteúdo será excluído e a linha ficará limpa.
Em seguida, utilizamos o segundo bloco Inserir Conteúdo na Célula e alimentamos a segunda coluna da primeira linha, célula "0:0", equivalente a "A1" no Excel. 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
No exemplo abaixo, o conteúdo "Esse texto será sobreposto" da célula A1 foi excluído ao criar uma linha por cima. A célula B1 foi preenchida pelo segundo bloco Inserir Conteúdo na Célula.
Figura 2 - Exemplo de efeito colateral do bloco Criar Linha
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.
Mais sobre
Consulte a documentação de suporte do Excel para quaisquer dúvidas.