LISTBOX SET PROPERTY

4D v17.4


LISTBOX SET PROPERTY ( {* ;} objeto ; propriedade ; valor )

Parâmetro	Tipo	Descrição
*	Operador	Se especificado, objeto é um nome de objeto (string). Se omitido, objeto é uma variável
objeto	Objeto de formulário	Nome de objeto (se * for especificado) ou Variável (se * for omitido)
propriedade	Inteiro longo	Propriedade List box ou coluna
valor	Inteiro longo, String	Valor de propriedade

Descrição

O comando LISTBOX SET PROPERTY define o valor da propriedade da coluna list box ou list box especificada utilizando os parâmetros objeto e *.

Se 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 for uma variável. Neste caso, se passar uma referência variável ao invés de uma string.

Nota: se o list box ou a coluna list box especificada utilizando os parâmetros objeto e * não existe, o comando não faz nada e não se dispara nenhum erro.

Nos parâmetros propriedade e valor, se indica, respectivamente, a propriedade a definir utilizando seu novo valor. Pode usar uma das constantes do tema:“List box”:

Constante	Tipo	Valor	Comentário
lk allow wordwrap	Inteiro longo	14
lk background color expression	Cadeia	22	Propriedade Background Color Expression para list box de tipo seleção Aplica a: List box ou coluna
lk column max width	Inteiro longo	26	Propriedade Maximum Width Aplica a: Coluna*
lk column min width	Inteiro longo	25	Minimum Width propriedade Aplicada a: Coluna*
lk column resizable	Inteiro longo	15	Propriedade Resizable Aplica a: Coluna* Valores possíveis: lk no (0) lk yes (1)
lk detail form name	Cadeia	19	Propriedade Detail Form Name para a seleção de tipo list box Aplica a: List box
lk display type	Inteiro longo	21
lk double click on row	Inteiro longo	18
lk extra rows	Inteiro longo	13
lk font color expression	Cadeia	23
lk font style expression	Cadeia	24
lk hide selection highlight	Inteiro longo	16
lk highlight set	Cadeia	27	Highlight Set propriedade para seleção tipo list box Aplica a: List box
lk multi style	Inteiro longo	30	Multi-style propriedade Aplica a: Column* Valores possíveis: lk no (0) lk yes (1)
lk named selection	Cadeia	28	Propriedade Named Selection para list box de tipo seleção Aplica a: List box
lk resizing mode	Inteiro longo	11	Column Auto-Resizing proriedade Aplica a: List box Possíveis valores: lk manual (0) lk automatic (1)
lk row height unit	Inteiro longo	17	Unidade de propriedade Row Height Aplica a: List box Possíveis valores: lk lines (1) lk pixels (0)
lk selection mode	Inteiro longo	10	Propriedade Selection Mode Aplica a: List box Valores possíveis: lk none (0) lk single (1) lk multiple (2)
lk single click edit	Inteiro longo	29	Propriedade Single-Click Edit Aplica a: List box Possíveis valores: lk no (0) lk yes (1)
lk sortable	Inteiro longo	20	Propriedade Sortable Aplica a: List box Valores possíveis: lk no (0) lk yes (1)
lk truncate	Inteiro longo	12	Propriedade Truncate with ellipsis Aplica a: List box ou coluna Valores possiveis: lk without ellipsis (0) lk with ellipsis (1)

*Estas propriedades só podem ser aplicadas à colunas list box; Entretanto, se passar um list box como parâmetro, LISTBOX SET PROPERTY aplica a propriedade a cada coluna de list box.

Nota: se passar uma propriedade que não existir, o que não está disponível para o list box ou coluna especificado, por exemplo lk font style expression no caso de um list box de tipo array, o comando não faz nada e não se dispara nenhum erro.

Exemplo 1

Se quiser ter certeza de que todas as colunas de list box "MyListbox" sejam redimensionáveis:

 LISTBOX SET PROPERTY(*;"MyListbox";lk column resizable;lk yes) //Todas as colunas de list box "MyListbox" são definidas como redimensionáveis

Exemplo 2

Se quiser definir a largura máxima da coluna "ProductNumber":

LISTBOX SET PROPERTY(*;"ProductNumber";lk column max width;200) //Esta coluna terá uma largura máxima de 200

Ver também

List box
LISTBOX Get property