4D Doc Center : LISTBOX SET ROW FONT STYLE

4D v14.3

LISTBOX SET ROW FONT STYLE


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).