4D Doc Center : OBJECT GET RGB COLORS

4D v14.3

OBJECT GET RGB COLORS


OBJECT GET RGB COLORS ( {* ;} objeto ; corPrimeiroPlano {; corFundo {; corFundoAlternativo}} )

Parâmetro	Tipo	Descrição
*	Operador	Se especificar, objeto é um nome de objeto (string) se omitido, objeto é uma variável ou campo.
objeto	Objeto de formulário	Nome do objeto (se * é especificado) ou Variável ou Campo (se * é omitido)
corPrimeiroPlano	Inteiro longo	Valor da cor RGB do primeiro plano
corFundo	Inteiro longo	Valor da cor do RGB para segundo plano (fundo)
corFundoAlternativo	Inteiro longo	Valor da cor RGB do fundo alternativo

Descrição

O comando OBJECT GET RGB COLORS devolve as cores de fundo e primeiro plano do objeto ou grupo de objetos designados por objeto.

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, é passada uma referência de campo ou variável (campo ou variável objeto unicamente) ao invés de um string.

Quando o comando é aplicado a um objeto de tipo List box, a cor de fundo alternativo das filas podem ser devolvidos no parâmetro corFundoAlternativo. Neste caso, o valor de corFundo é utilizado para o fundo das linhas ímpares.

Os valores de colores RGB devolvidos nos parâmetros a corPrimeiroPlano, corFundo e corFundoAlternativo são inteiros longos de 4 bytes em formato (0x00RRGGBB) ou os valores negativos correspondem aos cores "sistema". Neste último caso, pode comparar o valor obtido com as constantes do tema DEFINIR CORES RVA:

Constante	Tipo	Valor	Comentário
Background color	Inteiro longo	-2
Background color none	Inteiro longo	-16	Esta constante pode ser utilizada unicamente com os parâmetros corFundo e corFundoAlt.
Dark shadow color	Inteiro longo	-3
Disable highlight item color	Inteiro longo	-11
Foreground color	Inteiro longo	-1
Highlight menu background color	Inteiro longo	-9
Highlight menu text color	Inteiro longo	-10
Highlight text background color	Inteiro longo	-7
Highlight text color	Inteiro longo	-8
Light shadow color	Inteiro longo	-4

Nota: as cores "sistema" são aplicadas utilizando o comando OBJECT SET RGB COLORS.

Para obter mais informação sobre do formato dos parâmetros corPrimeiroPlano, corFundo e corFundoAlt, consulte a descrição do comando OBJECT SET RGB COLORS.