/
Criar Linha com Conteúdo / Create Line With Content

Criar Linha com Conteúdo / Create Line With Content

Cria uma linha com valor na célula de uma planilha Excel. Esse valor será inserido apenas na primeira coluna. Uma outra alternativa para o bloco Criar Linha com Conteúdo, é o bloco Criar Linha.

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.createLineWithValueSet()

Retorno

O bloco não possui retorno.

Parâmetros

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

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. Consulte a documentação de suporte do Excel para quaisquer dúvidas.

 

  • Posição: 2

  • Inglês: Number of line

  • Tipo: Texto / String

  • Exemplo: 0

Conteúdo 

Determina qual o conteúdo será inserido na linha.

  • Posição: 3

  • Inglês: Content

  • Tipo: Texto / String

  • Exemplo: "Novo conteúdo"

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". No parâmetro Número da Linha inserimos o valor da 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 2 - Exemplo de uso do bloco Criar Linha com Conteúdo

 

O resultado da execução da função da figura 2 pode ser conferido abaixo.

Figura 2.1 - 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".

O resultado pode ser observado na figura 3.1, onde podemos observar que 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 3.1 - Resultado da execução da figura 3

Nesta página