Mesclar Células
Combina duas ou mais células para criar uma célula maior.Esse bloco só é acessível após instalar o plugin Manipular Excel
| Nota | ||
|---|---|---|
| ||
A mesclagem de células preserva apenas o valor da célula superior esquerda e descarta outros valores. |
Parâmetros
Parâmetro | Nome | Doc | Tipo |
|---|---|---|---|
| Parâmetro 1 | Aba | String | Planilha que será modificada. |
| Parâmetro 2 | Primeira Linha | String | Número da primeira linha (horizontal) a ser combinada. |
| Parâmetro 3 | Última Linha | String | Número da última linha (horizontal) a ser combinada. |
| Parâmetro 4 | Primeira Coluna | String | Número da primeira coluna (vertical) a ser combinada. |
| Parâmetro 5 | Última Coluna | String | Número da última coluna (vertical) a ser combinada. |
Compatibilidade
Servidor
Exemplo
Na função Salvar a variável "arquivo" recebe o bloco Criar Arquivo Excel, o qual cria a pasta de trabalho Excel. A variável "planilha" recebe o bloco Criar Sheet, o qual cria a planilha. O bloco Inserir Valor na Célula insere na célula 0 o valor "novo". O bloco Inserir Valor na Célula é repetido para inserir o valor "exemplo" na célula 1. Após inserir os valores, o bloco Mesclar Células no parâmetro Sheet recebe a variável "planilha", o parâmetro Primeira Linha recebe o valor 0 e Última Linha o valor 1, em seguida, o parâmetro Primeira Coluna recebe o valor 0 e Última Coluna o valor 1. Como o arquivo Excel será criado na memória, o bloco Salvar Arquivo Excel salva o arquivo na pasta da aplicação e o arquivo pode ser baixado na raiz do projeto.
Figura 1 - Mesclando células
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 Inserir Conteúdo na Célula e inserimos o valor "Colunas mescladas" na célula "0:0", equivalente a célula "A1" no Excel.
Com o bloco Mesclar Células, informamos no parâmetro Aba a variável "aba", na Primeira Linha e Primeira Coluna o valor "0" (equivalente a linha 1 do Excel), no parâmetro Primeira Coluna incluímos o valor "0" (equivalente a coluna "A" no Excel) e na Última Coluna, o valor "5" (equivalente a coluna "E" no Excel). Dessa forma, definimos que será mesclado da célula "A1" até a célula "F1".
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 Mesclar Células
O resultado da execução da função da figura 1 pode visto na figura 2.
Figura 2 - Arquivo Excel com as células mescladas
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 | ||
| Informações | ||
| ||
Para entender melhor o funcionamento desse bloco e saber como incluí-lo no projeto, recomendamos acessar a documentação do plugin Manipular Excel. |