OBJECT SET COLOR

4D v16.3

OBJECT SET COLOR


OBJECT SET COLOR ( {* ;} objeto ; cor {; corAlternativa} )

Parâmetro	Tipo	Descrição
*	Operador	se especificado, objeto é um nome de objeto (string), se omitido, objeto é um campo ou uma variável
objeto	Campo, Variável	Nome de objeto (se * é especificado) ou campo ou variável (se * é omitido)
cor	Inteiro longo	Novas cores para o objeto
corAlternativa	Inteiro longo	Cores alternativas para uma list box

Descrição

O comando OBJECT SET COLOR define os cores do primeiro plano e do fundo dos objetos de formulário especificados por objeto. Se objeto é uma list box, é utilizado um parâmetro adicional para definir as cores do primeiro plano e do fundo das linhas pares (cores alternos).

Se passa o parâmetro opcional *, indica que o parâmetro objeto é um nome de objeto (string). Se não passa este parâmetro, indica que o parâmetro objeto é um campo ou uma variável. Neste caso, não passe uma referência de campo ou de variável ao invés de uma string (campo ou variável tipo objeto unicamente) ao invés de uma string. Para maior informação sobre nomes de objetos, consulte a seção Propriedades dos objetos

Se objeto especifica o objeto list box, as cores alternativas são utilizadas na totalidade do list box. Se objeto especifica uma coluna, só a coluna utilizará as cores definidas.

O parâmetro cor (como também altCor) define as cores de primeiro plano e fundo. A cor se calcula desta maneira:

Cor:=-(Primeiro plano+(256 * Fundo))

onde Primeiro plano e Fundo são números de cores (de 0 a 255) na paleta de cores.
Cor sempre é um número negativo. Por exemplo, se a cor do primeiro plano é 20 e a cor de fundo é 10, então cor é – (20 + (256 * 10)) ou –2580.

altColor é utilizada para especificar uma cor alternativa para as linhas pares de uma list box ou de uma coluna de list box. Em altColor, deve passar apenas a parte do "fundo" da fórmula de cor, ou seja, AltColor:=-(256 * Background).
Quando este parâmetro for passado, o parâmetro cor será aplicado para as linhas de nùmero par. Usar cores alternativas faz com que as listas sejam mais fàceis para ler. Se objeto especificar o objeto list box, cores alternantes seráo usadas em toda a list box. Se objeto especificar uma coluna, apenas a coluna usará esse conjunto de cores.

Nota: pode ver a paleta de cores na janela Lista de propriedades do editor de formulários.

Os números das cores mais utilizadas são fornecidos pelas seguintes constantes pré-definidas, localizadas no tema “Cores”:

Constante	Tipo	Valor
White	Inteiro longo	0
Yellow	Inteiro longo	1
Orange	Inteiro longo	2
Red	Inteiro longo	3
Purple	Inteiro longo	4
Dark blue	Inteiro longo	5
Blue	Inteiro longo	6
Light blue	Inteiro longo	7
Green	Inteiro longo	8
Dark green	Inteiro longo	9
Dark brown	Inteiro longo	10
Dark grey	Inteiro longo	11
Light grey	Inteiro longo	12
Brown	Inteiro longo	13
Grey	Inteiro longo	14
Black	Inteiro longo	15

Nota: enquanto que OBJECT SET COLOR trabalha com cores indexadas na paleta de cores de 4D, o comando OBJECT SET RGB COLORS que lhe permite trabalhar com qualquer cor RGB. Para reestabelecer as cores automáticas para um objeto, utilize o comando OBJECT SET RGB COLORS com as constantes Default foreground color e Default background color.

Exemplo 1

O exemplo a seguir define a cor da área de texto mostrado debaixo no editor de formulários:

Depois da execução da seguinte instrução:

OBJECT SET COLOR(*;"Meutexto";-(Yellow+(256*Red)))

... a área aparece como se observa a continuação:

Exemplo 2

Se quiser estabelecer uma cor de fundo alternativa para uma coluna na list box. Pode escrever:

OBJECT SET COLOR(*;"countryCol";-(Dark blue+(256*Red));-(256*Orange))

Ver também

Interação de comandos genéricos com textos multi estilos
OBJECT SET RGB COLORS