4D Doc Center : LISTBOX SET ROW COLOR

4D v14.3

LISTBOX SET ROW COLOR


LISTBOX SET ROW COLOR ( {* ;} objeto ; fila ; cor {; tipoCor} )

Parâmetro	Tipo	Descrição
*	Operador	Se especificado, objeto é um nome de objeto (cadeia) Se omitido, objeto é uma variável
objeto	Objeto de formulário	Nome de objeto (se * for especificado) ou Variável (se * for omitido)
fila	Inteiro longo	Numero de fila
cor	Inteiro longo	Valor de cor RGB
tipoCor	Inteiro longo	Cor de fonte do Listbox (por padrão) ou cor de fundo do Listbox

Descrição

Nota: Este comando só funciona com listboxes de tipo array.

O comando LISTBOX SET ROW COLOR define a cor de uma fila ou uma célula no listbox de tipo array designado pelos parâmetros objeto e *.

Se passar o parâmetro opcional * indica que o parâmetro objeto é um nome de objeto (cadeia). Se não passar este parâmetro, indica que o parâmetro objeto é uma variável. Neste caso, se passar uma referência de variável no lugar de uma cadeia.

Pode designar um listbox ou uma coluna do listbox no parâmetro objeto:

Quando o objeto designa um listbox, o comando se aplica a fila.
Quando o objeto designa uma coluna do listbox, o comando se aplica a célula localizada na interseção de coluna/fila.

Em fila, passe o número da fila na que deseja aplicar a nova cor.

Nota: O comando não leva em conta nenhum estado oculto/visível das filas do listbox.

Em cor, passe um valor de cor RGB. Para obter mais informação sobre as cores RGB, consulte a descrição do comando SET RGB COLORS. Se deseja que a fila herde o conjunto de cores para o nível mais alto, você pode passar a constante Listbox inherited no parâmetro cor.

No parâmetro tipoCor, passe as constantes Listbox background color ou Listbox font color para indicar se deseja aplicar a cor para o fundo ou para a cor de fonte da fila. Se omitir este parâmetro, a cor se aplica para a cor de fonte.

Este comando modifica os valores que se encontram no array de cores que podem ter sido definido para a coluna do listbox. Se estes acertos não estão definidos, o comando cria de forma dinâmica arrays que podem acessar mediante o comando LISTBOX Get array.

Se os valores de cor em conflito se definem usando as propriedades para os listboxes ou colunas do listbox, se aplica uma ordem de prioridade. Para obter mais informação, consulte o manual de Desenho.

Exemplo

Em um array de tipo list box, queremos estabelecer as cores de uma fila e para uma célula desta fila:

  // Definition of font color for cell (yellow)

 LISTBOX SET ROW COLOR(*;"Col5";3;0x00FFFF00)

 

  // Definição de fundo e cor de fonte para a fila 3

  // Fundo vermelho, fonte azul

 

 LISTBOX SET ROW COLOR(*;"ListBox";3;0x00FF0000;Listbox background color)

 LISTBOX SET ROW COLOR(*;"List Box";3;0x000000FF)