4D v16.3

LISTBOX SELECT BREAK

Página Inicial

 
4D v16.3
LISTBOX SELECT BREAK

LISTBOX SELECT BREAK 


 

LISTBOX SELECT BREAK ( {* ;} objeto ; fila ; coluna {; açao} ) 
Parâmetro Tipo   Descrição
Operador in Se especificado, objeto é um nome de objeto (string), se omitido, objeto é uma variável
objeto  Objeto de formulário in Nome de objeto (se* for especificado) ou variável (se * é omitido)
fila  Inteiro longo in Número de quebra de fila
coluna  Inteiro longo in Número de quebra de coluna
açao  Inteiro longo in Ação de seleçã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
lk add to 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.
lk remove from 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.
lk replace 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:



Ver também 

Gestão de List Boxes Hierárquicas
LISTBOX GET CELL POSITION
LISTBOX SELECT ROW

 
PROPRIEDADES 

Produto: 4D
Tema: List Box
Número 1117

 
HISTÓRIA 

Criado por: 4D v12

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v16)
Manual de linguagem 4D ( 4D v16.1)
Manual de linguagem 4D ( 4D v16.2)
Manual de linguagem 4D ( 4D v16.3)