Definir Propriedades de Fonte / Set Font Properties

Definir Propriedades de Fonte / Set Font Properties

Altera o tipo e a cor de uma fonte em uma célula.

Figura 1 - Bloco Definir Propriedades de Fonte

Compatibilidade

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

Retorno

O bloco não possui retorno.

Parâmetros

Número da linha

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.

  • Posição: 1

  • Inglês: Number of line

  • Tipo: Texto / String

  • Exemplo: "0"

Número da coluna

Recebe o número da coluna na planilha. Os valores inseridos neste campo são numéricos, começando sempre com 0, ao invés de "A", como é no Excel padrão. 

  • Posição: 2

  • Inglês: Number of the 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 da Fonte

Seleciona o tipo de formatação para a fonte. 

  • Posição: 4

  • Inglês: Font Type

  • Tipo: Objeto / Object

  • Exemplo: "Itálico"

  • Opções:

    • Itálico: formata a fonte com o tipo itálico.

    • Negrito: formata a fonte com o tipo negrito.

    • Sublinhado: formata a fonte com o tipo sublinhado,

    • Cortado: formata a fonte com o tipo cortado.

Cor da Fonte

Seleciona a cor para a fonte.

  • Posição: 5

  • Inglês: Font Color

  • Tipo: Objeto / Object

  • Exemplo: "Azul"

  • Opções:

    • Amarelo: destaca a fonte com a cor amarela.

    • Branco: destaca a fonte com a cor branca.

    • Vermelho: destaca a fonte com a cor vermelha.

    • Rosa: destaca a fonte com a cor rosa.

    • Verde: destaca a fonte com a cor verde.

    • Laranja: destaca a fonte com a cor laranja.

    • Magenta: destaca a fonte com a cor magenta.

    • Cinza Claro: destaca a fonte com a cor cinza claro.

    • Cinza: destaca a fonte com a cor cinza.

    • Cinza Escuro: destaca a fonte com a cor cinza escuro.

    • Azul Claro: destaca a fonte com a cor azul claro.

    • Azul: destaca a fonte com a cor azul.

    • Preto: destaca a fonte com a cor preta.

    • Amarelo: destaca a fonte com a cor amarela.

    • 14: destaca a fonte com a cor rosa.

Exemplo

Na função abaixo, o objeto da planilha é criado na variável “planilha” com o uso bloco Criar Planilha Excel. A aba (worksheet) “Aba1“ é inserida no objeto da planilha utilizando o bloco Criar Aba. Inserimos o bloco Inserir Conteúdo na Célula para adicionar o valor "Exemplo" na célula "0:0" (equivalente a A1 no Excel).

O bloco Definir Propriedades de Fonte foi configurado da seguinte forma: nos parâmetros Número da Linha e Número da Coluna inserimos o valor "0"; no parâmetro Aba inserimos a variável "aba" que usamos para criar a aba da planilha; no parâmetro Tipo da fonte escolhemos a opção "Itálico" e no parâmetro Cor da fonte, a cor "Azul". Ao final, utilizamos o bloco Salvar Planilha Excel, passando o objeto criado “planilha”, o nome do arquivo da planilha e o endereço onde será salvo.

Figura 2 - Exemplo de uso do bloco Definir Propriedades de Fonte

 

O resultado da execução da figura 2 pode ser conferido abaixo.

Figura 2.1 - Resultado da execução da função da figura 2