4D v14.3

GET LIST ITEM PARAMETER

Página Inicial

 
4D v14.3
GET LIST ITEM PARAMETER

GET LIST ITEM PARAMETER 


 

GET LIST ITEM PARAMETER ( {* ;} lista ; refElem | * ; seletor ; valor ) 
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 *)
refElem | *  Operador, Inteiro longo in Número de referencia do elemento, ou 0 para o último elemento adicionado à lista ou * para o elemento da lista atualmente selecionada
seletor  cadeia in Constante do parâmetro
valor  cadeia, Booleano, Real in Valor atual do parâmetro

O  comando GET LIST ITEM PARAMETER retorna o nome da fonte do caractere atual do elemento especificado pelo parâmetro refElem da lista cujo número de referência o nome de objeto se passa em lista.

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

Nota: se utiliza o caractere @ no nome de objeto da lista e o formulário contém várias listas que correspondem a este nome, ou GET LIST ITEM PARAMETER se aplicará ao primeiro objeto cujo nome corresponda.

Pode passar um número de referência em refElem. Se este número não corresponde a nenhum elemento da lista, o comando não faz nada. Também pode passar 0 em refElem para obter a fonte do último elemento adicionado à lista (utilizando APPEND TO LIST).

Finalmente, pode passar * em refElem: neste caso, o comando se aplicará ao elemento atual da lista. Se vários elementos são selecionados manualmente, o elemento atual é o último selecionado. Se nenhum elemento estiver selecionado, o comando não faz nada.

Em seletor, pode passar a constante Additional text (localizada no tema “Listas hierárquicas”) ou qualquer valor personalizado. Para maior informação sobre os parâmetros seletor e valor, consulte a descrição do comando SET LIST ITEM PARAMETER.

 
PROPRIEDADES 

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

 
HISTÓRIA 

Criado por: 4D v11 SQL

 
VER TAMBÉM 

Listas hierárquicas
SET LIST ITEM PARAMETER

 
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)