4D v14.3

Count list items

Página Inicial

 
4D v14.3
Count list items

Count list items 


 

Count list items ( {* ;} lista {; *} ) -> 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 *)
Operador in Se omitida (por padrão): Devolve os elementos visíveis (expandidos) da lista Se especificada: Devolve todos os elementos da lista
Resultado  Inteiro longo in Número de elementos visíveis da lista (expandidos) (se omitido o segundo *) ou número total de elementos da lista (se apresentado o segundo *)

O comando Count list items retorna o número atual de elementos visíveis ou o número total de elementos na lista cujo número de referência ou 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 de lista no formulário. Se não passar este parâmetro, você indica que o parâmetro lista é uma referência de lista hierárquica (refLista). Se utilizar apenas uma representação de lista, ou trabalha com todos os elementos (passa o segundo *), pode utilizar qualquer das duas sintaxes. Pelo contrário, se utilizar várias representações da mesma lista e trabalha com os elementos visíveis (o segundo * é omitido), 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 do objeto da lista e o formulário contém várias listas que coincidem com este nome, o comando Count list items será aplicado ao primeiro objeto cujo nome corresponda.

Utilize o segundo parâmetro * para determinar que tipo de informação será devolvida. Quando se passa este parâmetro, o comando retorna o número total de elementos presentes na lista, sem importar se a lista está exibida ou contraída.

Quando é omitido este parâmetro, o comando retorna o número de elementos visíveis, dependendo do estado expandido/contraído da lista e suas sub-listas.

Aplique este comando a uma lista mostrada num formulário.

Aqui temos uma lista chamada hList mostrada no ambiente Aplicação:


 $vlNbItems:=Count list items(hList) ` neste ponto $vlNbItems vale 8
 $vlNbTItems:=Count list items(hList;*) `$vlNbTItems também vale 8

 $vlNbItems:=Count list items(hList) ` neste ponto $vlNbItems vale 2
 $vlNbTItems:=Count list items(hList;*) `$vlNbTItems continua valendo 8

 $vlNbItems:=Count list items(hList) ` neste ponto $vlNbItems vale 5
 $vlNbTItems:=Count list items(hList;*) `$vlNbTItems continua valendo 8

 
PROPRIEDADES 

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

 
HISTÓRIA 

Modificado: 4D v11 SQL

 
VER TAMBÉM 

List item position
Selected list items

 
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)