OBJECT SET RGB COLORS
OBJECT SET RGB COLORS ( {* ;} objeto ; corPrimeiroPlano {; corFundo {; corFundoAlternativo}} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| * | Operador | → | se especificado, objeto é um nome de objeto (string), se omitido, objeto é um campo ou uma variável |
| objeto | any | → | Nome de objeto (se* é especificado) ou Campo ou Variável (se * é omitido) |
| corPrimeiroPlano | Text, Integer | → | Valor de cor RGB para a cor de Primeiro Plano |
| corFundo | Text, Integer | → | Valor RGB da cor de Fundo |
| corFundoAlternativo | Text, Integer | → | Valor RGB da cor de fundo alternativa |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
Descrição
O comando OBJECT SET RGB COLORS modifica as cores de fundo e primeiro plano dos objetos especificados por objeto e o parâmetro opcional *. Quando o comando é aplicado a um objeto list box, um parâmetro adicional lhe permite modificar a cor alternativa das filas.
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. Para maior informação sobre nomes de objetos, consulte a seção Propriedades dos objetos
O parâmetro opcional corFundoAlt lhe permite definir uma cor alternativa para o fundo das linhas pares. Este parâmetro só é utilizado quando o objeto é especificado como List box ou coluna de List box. Quando é utilizado este parâmetro, o parâmetro corFundo é utilizado para as linhas ímpares unicamente. A utilização de cores alternativos faz com que as listas sejam mais fáceis de ler.
Se objeto especifica um objeto List box, as cores alternativas são utilizadas em todo o List box. Se objeto especifica uma coluna da List box, só a coluna utilizará as cores definidas.
Definição de cores
Os valores das cores RGB são indicados nos parâmetros corPrimeirpoPlano, corFundo e corFundoAlt. Os formatos abaixo são compatíveis:
| Nombre del formato | Tipo | Descripción | Ejemplos |
|---|---|---|---|
| CSS color name | Texto | Nome de cor CSS2 padrão. A lista de nomes disponíveis pode ser encontrada em vários lugares na web, por exemplo, em htmlcolorcodes.com. Utiliza "transparente" para definir a transparencia no fundo (só pode ser utilizada com os parâmetros corFundo e corFundoAlt). Utiliza "" (string vazia) em corPrimeiroPlano ou corFundo para deixá-lo sem mudanças | "red", "cyan", "lightblue" |
| CSS color "#rrggbb" syntax | Texto | Código de cor hexadecimal CSS2 padrão: rr = componente vermelho da cor gg = componente verde da cor bb = componente azul da cor | "#ff0000", "#00FFFF", "#ADD8E6" |
| CSS color "rgb(r,g,b)" syntax | Texto | Código de cor rgb CSS2 padrão: r = componente vermelho da cor (0...255) g = componente verde da cor (0...255) b = componente azul da cor (0...255) | "rgb(255,255,0)", "rgb(255,0,0)" |
| 4-byte RGB value | Inteiro longo | Entero largo de 4 bytes (formato 0x00rrggbb). Valores hexadecimales: rr = componente vermelho da cor gg = componente verde da cor bb = componente azul da cor | 0x00000000, 0x00FF7F7F |
| 4D "system" color constant | Entero largo | Cores utilizadas por 4D para desenhar objetos com cores automáticas. Constantes disponíveis (do tema DEFINIR CORES RVA): Background color Background color none (só pode ser utilizada com os parâmetros corFundo e corFundoAlt) Dark shadow color Disable highlight item color Foreground color Highlight menu background color Highlight menu text color Highlight text background color Highlight text color Light shadow color | Nota: as cores automáticas dependem de sistema e do tipo de objeto ao qual são atribuídos. |
Exemplo 1
Este formulário contém duas variáveis editáveis, vsCorValor e vsCor assim como três barras termômetros: thVermelho, thVerde, e thAzul.
Estes são os métodos destes objetos:
// Método de objeto da variável não editável vsCorValor
Case of
:(FORM Event=On Load)
vsCorValor:="0x00000000"
End case
// Método de objeto da variável não editável vsCor
Case of
:(FORM Event=On Load)
vsColor:=""
OBJECT SET RGB COLORS(vsCor;0x00FFFFFF;0x0000)
End case
// Método de objeto do termômetro thVermelho
CLIQUE no TERMÔMETRO DE COR
// Método de objeto do termômetro thVerde
CLIQUE EM TERMOMETRO DE COR
// Método de objeto do termômetro thAzul
CLIQUE EM TERMOMETRO DE COR
O método de projeto chamado pelos três termômetros é:
// Método de projeto CLIQUE EM TERMOMETRO DE COR
OBJECT SET RGB COLORS(vsCor;0x00FFFFFF;(thVermelho<<&NBSP;16)+(thVerde&NBSP;<<&NBSP;8)+thAzul)
vsCorValor:=String((thVermelho<< 16)+(thVerde << 8)+thAzul;" & x")
If(thVermelho=0)
vsCorValor:=Substring(vsCorValor;1;2)+"0000"+Substring(vsCorValor;3)
End if
Note a utilização dos Bitwise operators para o cálculo dos valores das cores a partir dos valores dos termômetros.
Em execução, o formulário se vê assim:
Exemplo 2
Muda o fundo transparente com uma cor de fonte clara:
OBJECT SET RGB COLORS(*;"myVar";Light shadow color;Background color none)
Ver também
_o_OBJECT SET COLOR
OBJECT GET RGB COLORS
Select RGB Color