4D Doc Center : Count list items

4D v14.3

Count list items


Count list items ( {* ;} lista {; *} ) -> 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, cadeia	Número de referência de lista (se omitida ) ou Nome do objeto de tipo lista (se passada )
*	Operador	Se omitida (por padrão): Devolve os elementos visíveis (expandidos) da lista Se especificada: Devolve todos os elementos da lista
Resultado	Inteiro longo	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 )

Descrição

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.

Exemplos

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