4D Doc Center : LISTBOX SELECT BREAK

4D v14.3

LISTBOX SELECT BREAK


LISTBOX SELECT BREAK ( {* ;} objeto ; fila ; coluna {; açao} )

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 * é omitido)
fila	Inteiro longo	Número de quebra de fila
coluna	Inteiro longo	Número de quebra de coluna
açao	Inteiro longo	Ação de seleção

Descrição

O comando LISTBOX SELECT BREAK se utiliza para selecionar linhas de quebra no objeto list box designado pelos parâmetros objeto e *. O list box deve ser mostrado em modo hierárquico.

Se passa o parâmetro opcional *, indica que o parâmetro objeto é um nome de objeto (string). Se não passa este parâmetro, indica que o parâmetro objeto é uma variável. Neste caso, se passa uma referência de variável ao invés de uma string.

As linhas de ruptura são adicionadas para representar a hierarquia, pero no correspondem as línhas existentes no array. Para designar uma linha de ruptura a selecionar, deve passarnos parâmetros línha e coluna o número de linha e de coluna correspondente a primeira ocorrência no array correspondente. Estes valores são devolvidos pelo comando LISTBOX GET CELL POSITION quando o usuário for selecionado uma linha de quebra. Este princípio é descrito no parágrafo "Gestão das linhas de quebra" da seção Gestão de List Boxes Hierárquicas.

O parâmetro ação, se for passada, pode definir a ação de seleção que devem ser realizadas quando uma seleção de linhas de quebra existe no list box. Pode passar um valor ou uma das constantes a seguir, que seja encontrado no tema "List box" o tema:

Constante	Tipo	Valor	Comentário
Add to listbox selection	Inteiro longo	1	A linha selecionada é adicionada à seleção existente. Se a linha selecionada já pertence à seleção existente, o comando não faz nada.
Remove from listbox selection	Inteiro longo	2	A linha selecionada é removida da seleção existente. Se a linha especificada não pertence à seleção existente, o comando não faz nada.
Replace listbox selection	Inteiro longo	0	A linha selecionada torna-se a nova seleção e substitui a seleção existente. O comando tem o mesmo efeito que um clique do usuário em uma linha (no entanto, o evento On Clicked não é gerado). Esta é a ação padrão (se o parâmetro ação é omitido).

Exemplo

Dados os arrays a seguir representados num list box:

Queremos selecionar a linha de quebra "Normandy" na representação hierárquica destes arrays:

 $row:=Find in array(T2;"Normandy")

 $column:=2

 LISTBOX COLLAPSE(*;"MyListbox") `contração de todos os níveis

 LISTBOX SELECT BREAK(*;"MyListbox";$row;$column)

Este é o resultado: