List Box Object

List box de tipo array

Em um list box de tipo array, cada coluna deve estar associada a um array unidimensional 4D; podem ser utilizados todos os tipos de array, com exceção dos arrays de ponteiros. O número de linhas é baseado no número de elementos array.

Como padrão, 4D atribui o nome "ColumnX" para cada coluna. Você pode alterá-lo, assim como outras propriedades de coluna, nas propriedades das colunas. O formato de exibição de cada coluna também pode ser definido com o comando OBJECT SET FORMAT.

Os list boxes do tipo array podem ser exibidos em modo hierárquico, com mecanismos específicos.

Com list box de tipo array, o valor ingressado ou exibido são gerenciados usando a linguagem 4D. Você também pode associar uma lista de opções a uma coluna para controlar a entrada de dados. Os valores das colunas são gerenciados através de comandos List box de alto nível (como LISTBOX INSERT ROWS ou LISTBOX DELETE ROWS), bem como por comandos de manipulação de arrays. Por exemplo, para iniciar os conteúdos da coluna, pode usar a instrução abaixo:

ARRAY TEXT(varCol;size)

Também pode usar uma lista:

LIST TO ARRAY("ListName";varCol)

Aviso: quando uma list box contiver vários tamanhos diferentes de coluna, só o número de itens do menor array (coluna) será exibido. Tem que verificar que cada array tenha o mesmo número de elementos que os outros. Além disso, se uma coluna list box for vazia (isso ocorre quando o array associado não for corretamente declarado ou dimensionado usando a linguagem), a list box não exibe nada.

List box de tipo seleção

Nesse tipo de list box, cada coluna pode ser associada com um campo (por exemplo, [Employees]LastName) ou uma expressão. A expressão pode ser baseada em um ou mais campos (por exemplo, [Employees]FirstName+" "[Employees]LastName) ou pode ser simplesmente uma fórmula (por exemplo, String(Milliseconds)). A expressão também pode ser um método de proejeto, uma variável ou um item array. A expressão também pode ser um método de proejeto, uma variável ou um item array.

O conteúdo de cada linha é então avaliado de acordo com uma seleção de registros: a seleção atual de uma tabela ou uma seleção nomeada.

No caso de uma list box baseada na seleção atual de uma tablea, qualquer modificação feita do lado da database é refletida automaticamente na list box e vice versa. A seleção atual é portanto sempre a mesma em ambos os lugares.

List boxes Collection ou Entity selection

Nesse tipo de list box, cada coluna deve ser associada a uma expressão. Os conteúdos de cada linha são então avaliados por elemento de coleção ou por entidade da seleção de entidade.

Cada elemento da coleção ou cada entidade está disponível como um objeto que pode ser acessado por meio da palavra-chave This. A column expression can be a property path, a project method, a variable, or any formula, accessing each entity or collection element object through This, for example This.<propertyPath> (or This.value in case of a collection of scalar values). A expressão também pode ser um método de proejeto, uma variável ou um item array.

Quando a fonte de dados for uma seleção de entidades, qualquer modificação feita no lado da list box são salvas automaticamente na database. Do outro lado, modificações feitas na database são visíveis na list box depois que as entidades tocadas foram recarregadas.

Quando a fonte de dados for uma coleção, qualquer modificação feita nos valores da list box são refletidas na coleção. Por outro lado, se forem feitas modificações na coleção usando, por exemplo, as várias funções da classe Collection, você precisará notificar explicitamente o 4D reatribuindo a variável da coleção a ela mesma, para que o conteúdo do list box seja atualizado. Por exemplo:

myCol:=myCol.push("new value") //exibir novo valor na list box

Propriedades compatíveis

Propriedades compatíveis dependem do tipo de list box.

Propriedade	List box array	List box seleção	List box coleção ou entity selection
Cor de fundo alternativa	X	X	X
Cor de Fundo	X	X	X
Negrito	X	X	X
Expressão de cor de fundo		X	X
Estilo da linha de borda	X	X	X
Inferior	X	X	X
Classe	X	X	X
Seleção de coleção ou entidade		X	X
Redimensionamento automático de coluna	X	X	X
Item atual			X
Posição atual do item			X
Fonte de dados	X	X	X
Nome do formulário de detalhes		X
Exibir cabeçalhos	X	X	X
Exibir rodapés	X	X	X
Clique duas vezes na linha		X
Draggable	X	X	X
Droppable	X	X	X
Focusable	X	X	X
Fonte	X	X	X
Cor da fonte	X	X	X
Expressão de Cor da Fonte		X	X
Tamanho fonte	X	X	X
Altura (list box)	X	X	X
Altura (cabeçalhos)	X	X	X
Altura (rodapés)	X	X	X
Ocultar linhas em branco extras	X	X	X
Ocultar retângulo de foco	X	X	X
Ocultar destaque de seleção	X	X	X
List Box hierárquico	X
Highlight Set		X
Alinhamento Horizontal	X	X	X
Horizontal Line Color	X	X	X
Horizontal Scroll Bar	X	X	X
Dimensionamento horizontal	X	X	X
Italic	X	X	X
Left	X	X	X
Tabela mestre		X
Meta info expression			X
Método	X	X	X
Movable Rows	X
Seleção temporária		X
Number of Columns	X	X	X
Number of Locked Columns	X	X	X
Number of Static Columns	X	X	X
Object Name	X	X	X
Right	X	X	X
Row Background Color Array	X
Row Control Array	X
Row Font Color Array	X
Row Height	X
Row Height Array	X
Row Style Array	X
Selected Items			X
Selection Mode	X	X	X
Edição com um único clique	X	X	X
Ordenável	X	X	X
Ação padrão	X
Expressão de estilo		X	X
Top	X	X	X
Transparente	X	X	X
Tipo	X	X	X
Sublinhado	X	X	X
Variável ou Expressão	X	X
Alinhamento vertical	X	X	X
Cor da linha vertical	X	X	X
Barra de rolagem vertical	X	X	X
Tamanho Vertical	X	X	X
Visibilidade	X	X	X
Largura	X	X	X

Colunas list box, cabeçalhos e rodapés suportam propriedades específicas.

Eventos formulário suportados

Evento formulário	Propiedades adicionales devueltas (ver Evento formulario para las propiedades principales)	Comentários
On After Edit	column columnName row
On After Keystroke	column columnName row
On After Sort	column columnName headerName	fórmulas compostas não podem ser ordenadas. (por exemplo, This.firstName + This.lastName)
On Alternative Click	column columnName row	List box array unicamente
On Before Data Entry	column columnName row
On Before Keystroke	column columnName row
On Begin Drag Over	column columnName row
On Clicked	column columnName row
On Close Detail	[row](#propriedades adicionais)	Pode usar a constante lk inherited para imitar a aparência atual da list box (por exemplo, cor de fonte, cor de fundo, estilo da fonte, etc.).
On Collapse	column columnName row	Apenas list box hierárquicos
On Column Moved	columnName newPosition oldPosition
On Column Resize	column columnName newSize oldSize
On Data Change	column columnName row
On Delete Action	[row](#propriedades adicionais)
On Display Detail	isRowSelected row
On Double Clicked	column columnName row
On Drag Over	área [areaName](#propriedades adicionais) column columnName row
On Drop	column columnName row
On Expand	column columnName row	Apenas list box hierárquicos
On Footer Click	column columnName footerName	List box arrays, seleção atual e seleção temporal apenas
On Getting Focus	column columnName row	Propriedades adicionais devolvidas apenas quando se edita uma célula
On Header Click	column columnName headerName
On Load
On Losing Focus	column columnName row	Propriedades adicionais devolvidas apenas quando a edição de uma célula tiver sido concluída
On Mouse Enter	área [areaName](#propriedades adicionais) column columnName row
On Mouse Leave
On Mouse Move	área [areaName](#propriedades adicionais) column columnName row
On Open Detail	[row](#propriedades adicionais)	Pode usar a constante lk inherited para imitar a aparência atual da list box (por exemplo, cor de fonte, cor de fundo, estilo da fonte, etc.).
On Row Moved	newPosition oldPosition	List box array unicamente
On Selection Change
On Scroll	[horizontalScroll](#propriedades adicionais) verticalScroll
On Unload

Additional Properties

Os eventos formulário nos list box ou colunas de list box podem retornar as seguintes propriedades adicionais:

Propriedade	Tipo	Descrição
area	text	Área de objeto List box ("header", "footer", "cell")
areaName	text	Nome da zona
column	inteiro longo	Número da coluna
columnName	text	Nome da coluna
footerName	text	Nome do rodapé
headerName	text	Nome do cabeçalho
horizontalScroll	inteiro longo	Positivo se a deslocação for para a direita, negativo se for para a esquerda
isRowSelected	boolean	True se a linha estiver selecionada, senão False
newPosition	inteiro longo	Nova posição da coluna ou linha
newSize	inteiro longo	Novo tamanho (em pixéis) da coluna ou linha
oldPosition	inteiro longo	Posição anterior da coluna ou da linha
oldSize	inteiro longo	Tamanho anterior (em pixéis) da coluna ou linha
row	inteiro longo	Número da linha
Alinhamento vertical	inteiro longo	Positivo se a deslocação for para baixo, negativo se for para cima

Se um evento ocorrer em uma coluna ou linha "falsa" que não exista, é normalmente retornada uma cadeia de caracteres vazia.