LISTBOX Get row color
LISTBOX Get row color ( {* ;} objeto ; fila {; tipoCor} ) : Text
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| * | Operador | → | Se especificado, objeto é um nome objeto (string) Se omitido, objeto é uma variável |
| objeto | any | → | Nome de objeto (se * for especificado) ou Variável (se * for omitido) |
| fila | Integer | → | Número de Fila |
| tipoCor | Integer | → | Cor de Fonte de list box (padrão) ou cor de fundo de list box |
| Resultado | Text | ← | Valor da cor |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
Descrição
Nota: este comando só funciona com list boxes de tipo array.
O comando LISTBOX Get row color devolve a cor de uma fila ou célula na list box designada pelos parâmetros objeto e * como uma string CSS.
Nota: se quiser obter a cor como um formato inteiro longo de 4 bytes, deve utilizar o comando OBJECT SET RGB COLORS. Para saber mais sobre os formatos de cor, consulte a descrição do comando OBJECT SET RGB COLORS.
Passar o parâmetro opcional * indica que o parâmetro objeto é um nome de objeto (string). 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 ao invés de uma string. Pode designar uma list box ou uma coluna de list box no parâmetro objeto:
- quando objeto designar um list box, o comando devolve a cor da fila.
- quando objeto designar uma coluna de list box, o comando devolve a cor da célula.
Em fila, passe o número da fila cuja cor quiser obter.
Nota: o comando não leva em consideração nenhum estado oculto/visível das filas de list box.
No parâmetro tipoCor, pode passar a constante lk background color ou lk font color (tema "List box") para averiguar a cor de fundo ou fonte da fila. Se omitir este parâmetro, se devolve a cor da fonte.
Advertência: a cor atribuída a uma fila não é mostrada necessariamente em cada célula da fila (ver exemplo). Se os valores de cor em conflito sã estabelecidas utilizando as propriedades dos list boxes ou colunas de list box, se aplica uma ordem de prioridade. Para saber mais, consulte o manual de Desenho.
Exemplo
Dado a list box abaixo:
var $vtColor;$vtColor2;$vtColor3 : Text
$vtColor:=LISTBOX Get row color(*;"Col5";3)
$vtColor2:=LISTBOX Get row color(*;"List Box";3)
$vtColor3:=LISTBOX Get row color(*;"List Box";3;lk background color)
// $vtColor contains "#FFFF00" (yellow)
// $vtColor2 contains "#0000FF" (blue)
// $vtColor3 contains "#FF0000" (red)