Criar Linha
Cria uma uma linha no excel e arrasta o valor da linha anterior para a linha posterior na célula de uma planilha Excel.
Parâmetroslinha 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.
| Nota |
|---|
| Importante destacar que esse bloco não insere uma nova linha, movendo as linhas posteriores para baixo. Ao criar uma linha informando uma linha que já exista na planilha, essa linha será modificada e limpa. |
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
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" o bloco Criar Arquivo Excel, em seguida, 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 inserimos o valor "Exemplo", após isso, inserimos o bloco Criar Linha, onde no parâmetro Número da linha inserimos o número "0", após isso, no parâmetro Sheet inserimos a variável "planilha1" que usamos para criar a planilha, note que o valor que foi inserido na primeira linha foi para a linha posterior (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.
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 - Linha criada no excelExemplo 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.
| Informações | ||
|---|---|---|
| ||
Consulte a documentação de suporte do Excel para quaisquer dúvidas. |