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 | any | → | Nome do objeto (se * é especificado) ou Variável ou Campo (se * é omitido) |
| corPrimeiroPlano | Text, Integer | ← | Valor da cor RGB do primeiro plano |
| corFundo | Text, Integer | ← | Valor da cor do RGB para segundo plano (fundo) |
| corFundoAlternativo | Text, Integer | ← | Valor da cor RGB do fundo alternativo |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
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 cores RGB devolvidos nos parâmetros a corPrimerPlano, corFundo e corFundoAlternativo dependem do tipo de parâmetro:
- se passar um parâmetro de tipo texto, a cor é devolvida em formato CSS com a sintaxe "#rrggbb" (por exemplo: "# 0000FF")
- Se passar um parâmetro de tipo inteiro longo, a cor pode ser um inteiro longo de 4 bytes de formato (0x00RRGGBB) ou valores negativos correspondentes às cores de "sistema".
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.