4D Doc Center : LISTBOX SET HIERARCHY

4D v14.3

LISTBOX SET HIERARCHY


LISTBOX SET HIERARCHY ( {* ;} objeto ; hierárquico {; hierarquia} )

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 * for omitido)
hierárquico	Booleano	True = list box hierárquico False = list box não hierárquico
hierarquia	Array ponteiro	Array dos ponteiros

Descrição

O comando LISTBOX SET HIERARCHY permite configurar o objeto list box designado pelos parâmetros objeto e * em modo hierárquico ou não hierárquico.

Nota: este comando só funciona com os list box baseados em arrays. Quando este comando é utilizado com um list box baseado nas seleções, não faz nada.

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.

O parâmetro booleano hierarquico lhe permite especificar o modo do list box:

* Se passa True, o list box é mostrada em modo hierárquico,
* Se passa False, o list box é mostrada em modo não hierárquico (modo array padrão).

Quando se passa um list box em modo hierárquico, certas propriedades se restringem automaticamente. Para obter mais informação, consulte a seção .

O parâmetro hierarquia é utilizada para designar os arrays do list box a utilizar para a construção da hierarquia (ver exemplo).
Se mostra o list box em modo hierárquico e omite este parâmetro:

Se o list box já está em modo hierárquico, o comando não faz nada.
Se o list box está em modo não hierárquico e nunca tenha sido declarado hierárquico, o primeiro array é utilizado como a hierarquia por padrão.
Se o list box está em modo não hierárquico, mas previamente foi declarado hierárquico, a última hierarquia é reestabecida.

Exemplo

Definição dos arrays aPais, aRegião e aCidade como hierarquia de um list box:

 ARRAY POINTER($ArrHierarch;3)

 $ArrHierarch{1}:=->aPais `Primeiro nível de quebra

 $ArrHierarch{2}:=->aRegião `Segundo nível de quebra

 $ArrHierarch{3}:=->aCidade `Terceiro nível de quebra

 LISTBOX SET HIERARCHY(*;"mylistbox";True;$ArrHierarch)