4D v14.3

INSERT IN LIST

Página Inicial

 
4D v14.3
INSERT IN LIST

INSERT IN LIST 


 

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

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)

 
PROPRIEDADES 

Produto: 4D
Tema: Listas Hierárquicas
Número 625

 
HISTÓRIA 

Modificado: 4D v11 SQL

 
VER TAMBÉM 

APPEND TO LIST

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v12.4)
Manual de linguagem 4D ( 4D v11 SQL Release 6)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)