List item position

4D v16.3

List item position


List item position ( {* ;} lista ; refElem ) -> Resultado

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, String	Número de referência de lista (se omitida ) ou Nome do objeto de tipo lista (se passada )
refElem	Inteiro longo	Número de referência do elemento
Resultado	Inteiro longo	Posição do elemento em listas expandidas/contraídas

Descrição

O comando List item position retorna a posição do elemento cujo número de referencia ou nome de objeto se passa em refElem, na lista cujo número de referência se passa na lista .

Se passa o primeiro parâmetro opcional *, indica que o parâmetro lista é um nome de objeto (cadeia) correspondente a uma representação de 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 utilizada apenas uma representação de lista, ou trabalha com elementos estruturais (o segundo * é omitido), pode utilizar indiferentemente uma ou outra sintaxe. Por outro lado, se usar várias representações de uma mesma lista, a sintaxe baseada no nome do objeto é necessária já que cada representação pode ter sua própria configuração expandida/contraída.

Nota: se utilizar o caractere @ no nome da lista e o formulário contém várias listas que respondem a este nome, o comando List item position só aplicará ao primeiro objeto cujo nome corresponda.

Nota: diferente de outros comandos deste tema, este comando não permite passar o valor 0 em refElem para designar o último item adicionado.

A posição é expressa com relação ao elemento superior da lista, utilizando o estado atual expandido/contraído da lista e sua sub-lista.

O resultado é um número entre 1 e o valor retornado por Count list items.

Se o elemento não é visível porque está localizado em uma lista contraída, List item position expande a lista correspondente de maneira que o elemento seja visível.

Se o elemento não existir, List item position retorna 0.

Ver também

Count list items
SELECT LIST ITEMS BY REFERENCE