4D Doc Center : LISTBOX EXPAND

4D v14.3

LISTBOX EXPAND


LISTBOX EXPAND ( {* ;} object {; recursive {; selector {; linha \| nivel {; coluna}}}} )

Parâmetro	Tipo	Descrição
*	Operador	If specified, object is an object name (string) If omitted, object is a variable
object	Objeto de formulário	Object name (if * is specified) or Variable (if * is omitted)
recursive	Booleano	True = expand sublevels False = do not expand sublevels
selector	Inteiro longo	Part of list box to expand
linha \| nivel	Inteiro longo	Number of break row to expand or Number of list box level to expand
coluna	Inteiro longo	Number of break column to expand

Descrição

O comando LISTBOX EXPAND é utilizado para expandir as linhas de quebra do objeto list box designado pelos parâmetros objeto e *.

Se passa o parâmetro opcional *, indica que o parâmetro objeto é um nome de objeto (string). Se omitir este parâmetro, indica que o parâmetro objeto é uma variável. Nesse caso, não passa uma string, mas uma referência de variável.

Se a list box não estiver configurada em modo hierárquico, o comando não faz nada. Para mais informações sobre list box hierárquicas, consulte Gestão de List Boxes Hierárquicas.

O parâmetro opcional recursivo é utilizado para configurar a expansão dos subníveis hierárquicos do list box. Passe Verdadeiro ou omita este parâmetro para que o comando provoque a expansão de todos os níveis e subníveis. Se passa Falso, só o primeiro nível especificado será exibido.

O parâmetro opcional selector é utilizado para especificar o alcance do comando. Pode passar neste parâmetro uma das seguintes constantes do tema List box:

Constante	Tipo	Valor	Comentário
Listbox all	Inteiro longo	0	O comando afeta todos os subníveis (valor por defeito, utilizado se o parâmetro for omitido).
Listbox selection	Inteiro longo	1	O comando afeta os subníveis selecionados.
Listbox break row	Inteiro longo	2	O comando afeta o subnível ao qual pertence a "célula" designada pelos parâmetros linha e coluna. Note que estes parâmetros representam os números de linha e de coluna na list box de modo padrão e não na sua presentação hierárquica. Se os parâmetros linha e coluna forem omitidos, o comando não faz nada.
Listbox level	Inteiro longo	3	O comando afeta todas as quebras de linhas correspondentes à coluna nivel. Este parâmetro designa um número de coluna na list box no modo padrão e não na sua representação hierárquica. Se o parâmetro nivel for omitido, o comando não faz nada.

O comando não seleciona linhas de quebra.

Se a seleção ou o list box não conterem uma linha de quebra ou se todas as linhas de quebra já estão expandidas, o comando não faz nada.

Exemplo

This example illustrates different ways of using the command. Given the following arrays shown in a list box:

  //Expand all the break rows and subrows of the list box

 LISTBOX EXPAND(*;"MyListbox")

  //Expand the first level of break rows of the selection

 LISTBOX EXPAND(*;"MyListbox";False;Listbox selection)

  //If the "Belgium" row was selected

  //Expand the Brittany break row with recursion

 LISTBOX EXPAND(*;"MyListbox";False;Listbox break row;1;2)

  //Expand all the first columns (countries) without recursion

 LISTBOX EXPAND(*;"MyListbox";False;Listbox level;1)