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. You can change it, as well as other column properties, in the column properties. The display format for each column can also be defined using the OBJECT SET FORMAT command.

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. The values of columns are managed using high-level List box commands (such as LISTBOX INSERT ROWS or LISTBOX DELETE ROWS) as well as array manipulation commands. 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. You can use the LISTBOX SET COLUMN FORMULA and LISTBOX INSERT COLUMN FORMULA commands to modify columns programmatically.

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.

nota

Quando as entidades são excluídas, suas referências permanecem na seleção da entidade com um valor undefined, assim exibindo linhas em branco no list box. Neste caso, você pode chamar a função .clean() para obter uma nova seleção de entidade, mas sem as referências de entidade deletadas.

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
Arrastável	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 Padding	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
Relleno 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.

Supported Form Events

Evento formulário	Propriedades adicionais retornadas (consulte Form event para obter as propriedades principais)	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	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
On Display Detail	isRowSelected row
On Double Clicked	column columnName row
On Drag Over	area areaName 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	area areaName column columnName row
On Mouse Leave
On Mouse Move	area areaName column columnName row
On Open Detail	row	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 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.