4D v14.3

List item position

Página Inicial

 
4D v14.3
List item position

List item position 


 

List item position ( {* ;} lista ; refElem ) -> Resultado 
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  Inteiro longo in Número de referência do elemento
Resultado  Inteiro longo in Posição do elemento em listas expandidas/contraídas

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.

 
PROPRIEDADES 

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

 
HISTÓRIA 

Modificado: 4D v11 SQL

 
VER TAMBÉM 

Count list items
SELECT LIST ITEMS BY REFERENCE

 
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)