/
Mesclar Células / Merge Cells

Mesclar Células / Merge Cells

Combina duas ou mais células em uma só, formando uma célula maior.

Figura 1 - Bloco Mesclar Células

 

Este bloco faz parte do plugin Excel. Para visualizá-lo, é necessário instalar o plugin.

Compatibilidade

  • Bloco servidor: cronapi.excel.Excel.mergeCells()

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: 1

  • Inglês: Sheet

  • Tipo: Objeto / Object

  • Exemplo: uso do retorno do bloco Criar Aba

Primeira Linha

Número da primeira linha (horizontal) a ser mesclada. A contagem começa em zero (0), diferentemente do Excel, que inicia em um (1).

  • Posição: 2

  • Inglês: First Line

  • Tipo: Texto / String

  • Exemplo: "0"

Última Linha

Número da última linha (horizontal) a ser mesclada. A contagem começa em zero (0), diferentemente do Excel, que inicia em um (1).

  • Posição: 3

  • Inglês: Last Line

  • Tipo: Texto / String

  • Exemplo: "1"

Primeira Coluna

Recebe o número da primeira coluna a ser mesclada. Os valores inseridos neste parâmetro são numéricos, iniciando em 0 (equivalente à coluna 'A' no Excel).

  • Posição: 4

  • Inglês: First Column

  • Tipo: Texto / String

  • Exemplo: "0"

Última Coluna

Recebe o número da última coluna a ser mesclada. Os valores inseridos neste parâmetro são numéricos, iniciando em 0 (equivalente à coluna 'A' no Excel).

  • Posição: 5

  • Inglês: Last Column

  • Tipo: Texto / String

  • Exemplo: "3"

Exemplo

Na função abaixo, na variável "planilha" é criado o objeto da planilha a partir do bloco Criar Planilha Excel. Na planilha criada será adicionada a aba "Aba 1" por meio do bloco Criar Aba inserido na variável "aba". O bloco Inserir Conteúdo na Célula adiciona o conteúdo desejado na posição A1 (referência padrão do Excel).

Em seguida, o bloco Mesclar Células será responsável por unir as linhas e colunas especificadas. No parâmetro Primeira Linha, inserimos o valor '0' (equivalente a linha 1 do Excel) e na Última Linha o valor '1' (equivalente à linha 2). Para as colunas, informamos o valor '0' em Primeira Coluna (equivalente à coluna 'A' no Excel) e o valor '5' na Última Coluna (equivalente a coluna 'F'). Dessa forma, definimos que será mesclado da célula 'A1' até a célula 'F2'.

Por fim, o bloco Salvar Planilha Excel salvará o arquivo gerado no local especificado.

Figura 2 - Exemplo de uso do bloco Mesclar Células

 

Na imagem abaixo, podemos visualizar a planilha criada de acordo com as configurações da função da Figura 2. Observe que as linhas '1' e '2' e as colunas de 'A' até 'F' foram mescladas em uma única célula.

Figura 2.1 - Visualização do arquivo gerado

Nesta página