/
Alinhar o Conteúdo Verticalmente / Align Cell Text Vertical

Alinhar o Conteúdo Verticalmente / Align Cell Text Vertical

Alinha verticalmente um valor na célula de uma planilha Excel.

Figura 1 - Bloco Alinhar o Conteúdo Verticalmente

 

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

Compatibilidade

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

Retorno

O bloco não possui retorno.

Parâmetros

Número da Linha

Número da linha da célula a ter seu conteúdo alinhado. A contagem começa em zero (0), diferentemente do Excel, que inicia em um (1).

  • Posição: 1

  • Inglês: Number of Line

  • Tipo: Texto / String

  • Exemplo: "0"

Número da Coluna

Número da coluna da célula a ter seu conteúdo alinhado. Os valores inseridos neste parâmetro são numéricos, iniciando em 0 (equivalente à coluna 'A' no Excel).

  • Posição: 2

  • Inglês: Number of Column

  • Tipo: Texto / String

  • Exemplo: "0"

Aba

Objeto que representa a aba do arquivo Excel. Deve-se utilizar o retorno do bloco Criar Aba.

  • Posição: 3

  • Inglês: Sheet

  • Tipo: Objeto / Object

  • Exemplo: uso do retorno do bloco Criar Aba

Tipo de Alinhamento

Define o tipo de alinhamento a ser aplicado à célula.

  • Posição: 4

  • Inglês: Align Type

  • Tipo: Objeto / Object

  • Exemplo: "Alinhamento no Topo"

  • Opções:

    • Alinhamento no Topo: alinha o texto para que ele fique próximo à margem superior da célula.

    • Centralizado: alinha o texto ao centro da célula na vertical.

    • Alinhamento Abaixo: alinha o texto para que ele fique próximo à margem inferior da célula.

    • Alinhamento Justificado: o texto é distribuído na célula uniformemente de cima para baixo.

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, por meio do bloco Alinhar o Conteúdo Verticalmente, o texto inserido na célula configurada será alinhado ao centro. Por fim, o bloco Salvar Planilha Excel salvará o arquivo gerado no local especificado.

Figura 2 - Exemplo de uso do bloco Alinhar o Conteúdo Verticalmente

 

Na imagem abaixo, podemos visualizar o resultado de execução da função da Figura 2.

Figura 2.1 - Visualização do arquivo gerado

Nesta página