4D Doc Center : INSERT IN LIST

4D v14.3

INSERT IN LIST


INSERT IN LIST ( {* ;} lista ; antesElem \| * ; textoElem ; refElem {; sublista ; expandida} )

Parâmetro	Tipo	Descrição
*	Operador	Se especificada, lista é um nome de objeto (cadeia) Se omitida, lista é um número de referência de lista
lista	ListRef, cadeia	Número de referência de lista (se omitida ) ou Nome do objeto de tipo lista (se passada )
antesElem \| *	Inteiro longo, Operador	Número de referencia do elemento, ou 0 para o último elemento adicionado à lista ou * para o elemento da lista atualmente selecionada
textoElem	cadeia	Texto para o novo elemento (max. 255 caracteres)
refElem	Inteiro longo	Número de referencia único do novo elemento
sublista	ListRef	Sub-lista opcional para associar ao novo elemento
expandida	Booleano	Indica se a sub-lista será expandida ou contraída

Descrição

O comando INSERT IN LIST insere o elemento designado pelo parâmetro refElem na lista cujo número de referência é passado em lista.

Se passa o primeiro parâmetro opcional *, indica que el parâmetro lista é um nome de objeto (cadeia) correspondente a uma representação da lista no formulário. Se não passa este parâmetro, indica que o parâmetro lista é uma referência de lista hierárquica (RefLista). Se utilizar uma só representação de lista ou trabalha com os elementos estruturais (o segundo * é omitido), pode utilizar indiferentemente uma ou outra sintaxe. Pelo contrário, se utilizar várias representações da mesma lista e trabalha com o elemento atual (se passa o segundo *), a sintaxe baseada no nome do objeto é necessária já que cada representação tem seu próprio elemento atual.

O parâmetro antesElem pode ser utilizada para designar o elemento antes do qual você queira inserir o novo elemento:

Pode passar o valor 0 com o objetivo de designar o último elemento adicionado à lista. O novo elemento inserido será convertido então no elemento selecionado.
Pode passar * para que o novo elemento seja inserido antes do elemento selecionado atualmente na lista. Neste caso, o novo elemento inserido é convertido no elemento selecionado.
Por outra parte, se deseja inserir um elemento antes de um item específico, passe o número de referência desse elemento. Neste caso, o novo elemento inserido não é selecionado automaticamente. Se não houver um elemento com o número de referência correspondente, o comando não faz nada.

Passe o texto e o número de referência do novo elemento nos parâmetros textoElem e refElem.

Se deseja que o elemento inclua sub elementos, passe um número de referência de lista válido no parâmetro sublista. Neste caso, também deve passar o parâmetro expandida. Passe True ou False neste parâmetro de maneira que esta sub-lista é mostrada expandida ou contraída respectivamente.

Exemplo

O código a seguir insere um elemento (sem sub-lista associada) justo antes do elemento selecionado atualmente n lista hList:

 vlUniqueRef:=vlUniqueRef+1

 INSERT IN LIST(hList;*;"Novo elemento";vlUniqueRef)