Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
Mesclar Células
Combina duas ou mais células para criar uma célula maior.
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
A função "Salvar" (Figura 1) contém todos os blocos desde a criação até o salvamento do arquivo.
Assim, ela inicia com a variável "arquivo" recebendo o bloco Criar Arquivo Excel, no qual cria a pasta de trabalho Excel. A variável "planilha" recebe o bloco Criar Sheet, no qual cria a planilha. O bloco Inserir Valor na Célula insere na célula 0:0 o valor "novo". O bloco Inserir Valor na Célula é repetido para inserir o valor "exemplo" na célula 0:1. Após inserir os valores, o bloco Mesclar Células recebe no parâmetro Sheet a variável "planilha", o parâmetro Primeira Linha recebe o valor 0 e Última Linha o valor 0, 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, o arquivo pode ser baixado na raiz do projeto e as células mescladas aparecerão, conforme a Figura 2.
Image Removed
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.
Image Added
Figura 1 - Bloco Mesclar Células
O resultado da execução da função da figura 1 pode visto na figura 2.
Image AddedImage Removed
Figura 2 - Arquivo Excel com as células mescladas
title | Observação |
---|
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. |