Count list items

Count list items ( {* ;} lista {; *} ) : Integer

Parámetro	Tipo		Descripción
*	Operador	→	Si se especifica, lista es un nombre de objeto (cadena) Si se omite, lista es un número de referencia de lista
lista	Integer, Text	→	Número de referencia de lista (si se omite *) o Nombre del objeto de tipo lista (si se pasa *)
*	Operador	→	Si se omite (por defecto): Devuelve los elementos visibles (desplegados) de la lista Si se especifica: Devuelve todos los elementos de la lista
Resultado	Integer	←	Número de elementos visibles de la lista (desplegados) (si se omite el segundo *) o número total de elementos de la lista (si se presenta el segundo *)

Descripción

El comando Count list items devuelve el número actual de elementos visibles o el número total de elementos en la lista cuyo número de referencia o nombre de objeto se pasa en lista.

Si pasa el primer parámetro opcional *, indica que el parámetro lista es un nombre de objeto (cadena) correspondiente a una representación de lista en el formulario. Si no pasa este parámetro, usted indica que el parámetro lista es una referencia de lista jerárquica (refLista). Si utiliza una sola representación de lista o trabaja con todos los elementos (pasa el segundo *), puede utilizar cualquiera de las dos sintaxis. Por el contrario, si usted utiliza varias representaciones de la misma lista y trabaja con los elementos visibles (el segundo * se omite), la sintaxis basada en el nombre del objeto es necesaria ya que cada representación puede tener su propia configuración desplegada/contraída.

Nota: si utiliza el carácter @ en el nombre del objeto de la lista y el formulario contiene varias listas que coinciden con este nombre, el comando Count list items se aplicará al primer objeto cuyo nombre corresponda.

Utilice el segundo parámetro * para determinar que tipo de información se devolverá. Cuando se pasa este parámetro, el comando devuelve el número total de elementos presentes en la lista, sin importar si la lista está desplegada o contraída.

Cuando se omite este parámetro, el comando devuelve el número de elementos visibles, dependiendo del estado expandido/contraído de la lista y sus sublistas.

Aplique este comando a una lista mostrada en un formulario.

Ejemplos

Acá tenemos una lista llamada hList mostrada en el entorno Aplicación:

 $vlNbItems:=Count list items(hList) // en este punto $vlNbItems vale 8
 $vlNbTItems:=Count list items(hList;*) //$vlNbTItems también vale 8

 $vlNbItems:=Count list items(hList) // en este punto $vlNbItems vale 2
 $vlNbTItems:=Count list items(hList;*) //$vlNbTItems continúa valiendo 8

 $vlNbItems:=Count list items(hList) // en este punto $vlNbItems vale 5
 $vlNbTItems:=Count list items(hList;*) //$vlNbTItems continúa valiendo 8

Ver también

List item position
Selected list items

Propiedades

Número de comando	380
Hilo seguro	✗