4D v14.3

LISTBOX EXPAND

Página Inicial

 
4D v14.3
LISTBOX EXPAND

LISTBOX EXPAND 


 

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

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)

 
PROPRIEDADES 

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

 
HISTÓRIA 

Criado por: 4D v12

 
VER TAMBÉM 

LISTBOX COLLAPSE

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)

Parent of : LISTBOX EXPAND ( 4D v12.4)