Inserir
ValorConteúdo na Célula
Insere um valor na célula de uma planilha Excel.
Esse bloco só é acessível após instalar o plugin Manipular Excel.
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 | Número da coluna | String | Recebe o |
| número da coluna na planilha. Os valores inseridos neste campo são numéricos, começando sempre com 0 (equivalente a "A", como é no Excel padrão). | |||
| Parâmetro 3 | Aba | String | Recebe a variável |
| com a referência da aba da planilha. | |||
| Parâmetro 4 | Conteúdo | String | Determina qual o valor será inserido na célula. |
Servidor
Exemplo
A função Inserir (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 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 "1", 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.
tipNa função abaixo, o objeto da planilha é criado na variável “novo”, em seguida, a aba (worksheet) “Aba1“ é inserida no objeto da planilha utilizando o blocoCriar Aba. Utilizamos o bloco Inserir Conteúdo na Célula para indicar a localização do conteúdo (equivalente a A1 no Excel), passando a referência da aba que criamos com o bloco Criar Aba (variável "aba") e informamos o conteúdo a ser adicionado no parâmetro Conteúdo. 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 Inserir Conteúdo na Célula
Na figura 2 podemos ver o resultado da aplicação do bloco, note que nos campos Número da Linha e Número da Coluna, inserimos o valor 0, respectivamente, isso é equivalente à posição A1 no Excel padrão.
Figura 2 - Conteúdo inserido na célula
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.
Figura 1 - Bloco Inserir Valor na Célula
| Informações | ||
|---|---|---|
| ||
Para entender melhor o funcionamento desse bloco e saber como incluí-lo no projeto, recomendamos acessar Consulte a documentação de suporte do plugin Manipular Excel para quaisquer dúvidas. |