Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
Criar Linha
Insere um valor na célula de uma planilha Excel.
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.
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. |
Compatibilidade
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 determinamos qual célula iremos inserir o valor com o parâmetro Número da Linha e o parâmetro Número da Coluna, onde inserimos o número "0", após isso, no parâmetro Sheet inserimos a variável "planilha1" que usamos para criar a planilha, em seguida, na variável Valor escrevemos "Exemplo" que será o valor inserido na célula que definimos (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.
Image RemovedFigura 1 - Bloco Criar Linha
Image Removed
Figura 2 - Linha criada no excelNa 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.
Image Added
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.
Image Added
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.
Informações | ||
---|---|---|
| ||
Consulte a documentação de suporte do Excel para quaisquer dúvidas. |