LISTBOX SET ROW FONT STYLE

4D v18


LISTBOX SET ROW FONT STYLE ( {* ;} objeto ; fila ; estilo )

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	Número de fila
estilo	Inteiro longo	Estilo de fonte

Descrição

Nota: Este comando só funciona com os list boxes de tipo array.

O comando LISTBOX SET ROW FONT STYLE estabelece um estilo de fonte para uma fila ou uma célula no list box tipo array designado pelos parâmetros objeto e * .

Ao 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 em lugar de uma cadeia.

Pode designar um list box ou uma coluna de list box no parâmetro de objeto:

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

Em fila, passe o número da fila na que deseja aplicar o novo estilo.

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

Em estilo, se passar um valor de estilo. Deve utilizar um (ou uma combinação) das constantes que se encontram no tema Estilos de fonte:

Constante	Tipo	Valor
Bold	Inteiro longo	1
Italic	Inteiro longo	2
Plain	Inteiro longo	0
Underline	Inteiro longo	4

Se um array de estilos de fonte foi associado com o list box ou coluna, só o elemento correspondente a fila se modifica. Em outras palavras, a execução do comando tem o mesmo efeito, neste caso, como modificação de um elemento do array estilo de fonte.
Se não há um array estilo de fonte associado com o list box ou coluna, será criada de forma dinâmica quando se chama a este comando. Se pode acessar a eles usando o comando LISTBOX Get array.

Se as propriedades de estilo em conflito se estabelecem para a coluna ou o list box, se aplica uma ordem de prioridade. Para obter mais informação, consulte o manual de Desenho.

Nota: Dado que os estilos de array para as colunas tem prioridade sobre os dos list boxes, ao aplicar este comando a um list box, só terá efeito se não há estilo de array atribuído as colunas.

Exemplo

Dado um array de tipo list box com as seguintes características:

Um array de estilo de fonte associado com o list box (ArrGlobalStyle)
Um array de estilo de fonte associado com a coluna 5 (ArrCol5Style)
As outras colunas não tem arrays de estilo.

 LISTBOX SET ROW FONT STYLE(*;"Col5";3;Bold)

  // equivalente a ArrCol5Style{3}:=Bold

 LISTBOX SET ROW FONT STYLE(*;"List Box";3;Italic+Underline)

  // equivalente a ArrGlobalStyle{3}:=Italic+Underline

Depois da segunda declaração, todas as células da terceira fila mudam de fila a sublinhadas em cursiva, a exceção da célula da quinta coluna que fica só em negrito (os arrays de estilo de coluna tem prioridade sobre os arrays de list box).

Ver também

LISTBOX Get row font style
LISTBOX SET ROW COLOR