Define uma cor de fundo na célula de uma planilha Excel.
Parâmetros
Parâmetro
Nome
Tipo
Doc
Parâmetro 1
Número da Linha
String
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.
Parâmetro 2
Número da Coluna
String
Recebe o número da coluna na planilha. Os valores inseridos neste campo são numéricos, começando sempre com 0(equivalente a "A", como é no Excel padrão).
Parâmetro 3
Aba
String
Recebe a variável que usamos para criar a aba da planilha.
Parâmetro 4
Cor
String
Determina qual a cor do fundo da célula.
OBS: Só é possível utilizar as cores sugeridas.
Parâmetro 5
Padrão de Preenchimento
String
Determina o padrão de preenchimento da célula, podendo ser (figura 3).
Sem Preenchimento
Solidamente Preenchido
Pequenos Pontos Finos
Pontos Largos
Pontos Esparsos
Faixas Horizontais Espessas
Faixas Verticais Espessas
Compatibilidade
Servidor
Exemplo
Na função abaixo, o objeto da planilha é criado na variável “novo”, com o blocoCriar Planilha Excel, em seguida, a aba (worksheet) “Aba1“ é inserida no objeto da planilha utilizando o blocoCriar Aba.
Após isso, inserimos o bloco Definir Cor de Preenchimento e nos parâmetros Número da Linha e Número da Coluna atribuímos o valor “0”, no parâmetro Aba inserimos a variável "aba" que usamos para criar a aba da planilha, em seguida, no parâmetro Cor selecionaremos "Amarelo" que será a cor inserida na célula que definimos, por último, definimos o Padrão de Preenchimento, para este exemplo escolhemos "Solidamente preenchido".
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 Definir Cor de fundo
O resultado da função da figura 1 pode ser visto na figura abaixo.
Figura 2 - Fundo amarelo aplicado na célula
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.
Mais sobre
Consulte a documentação de suporte do Excel para quaisquer dúvidas.
Tipos de padrão de preenchimento
Abaixo seguem os tipos de padrões de preenchimento que podem ser adicionados à célula.