| 4D v13.4LISTBOX SELECT BREAK | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 
 | 
    4D v13.4
 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 | |||||
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 .
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 "" 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). | 
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:

	Produto: 4D
	Tema: List Box
	Número 
        1117
        
        
        
	
	Criado por: 4D v12
Gestão de List Boxes Hierárquicas
GET LISTBOX CELL POSITION
SELECT LISTBOX ROW