/
Criar Linha / Create Line

Criar Linha / Create Line

Cria uma linha em uma planilha Excel. Uma outra alternativa para o bloco Criar Linha, é o bloco Criar Linha com Conteúdo.

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 que já possuem esse recurso, como é o caso do bloco Inserir Conteúdo na Célula ou Criar Linha com Conteúdo.

Figura 1 - Bloco Criar Linha

 

Este bloco faz parte do plugin Excel. Para visualizá-lo, é necessário instalar o plugin. 

É 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.

Compatibilidade

  • Bloco servidor: cronapi.excel.Excel.createLine()

Retorno

Retorna os dados representando a linha criada.

Parâmetros

Número da linha

Recebe o número da linha na planilha, começando sempre com o valor zero, ao invés de 1. 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.

  • Posição: 1

  • Inglês: Number of line

  • Tipo: Texto / String

  • Exemplo: "0"

Aba

Objeto que representa a aba do arquivo Excel. Deve-se utilizar o retorno do bloco Criar Aba.

  • Posição: 3

  • Inglês: Sheet

  • Tipo: Objeto / Object

  • Exemplo: uso do retorno do bloco Criar Aba

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 2 - Exemplo de uso do 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. Assim, a célula B1 foi preenchida pelo segundo bloco Inserir Conteúdo na Célula.

Figura 2.1 - Resultado da execução da função da figura 2

Nesta página