Count list items

4D - Documentation   Français   English   German   Español   English   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente

versión 11 (Modificado)


Count list items (*; lista{; *}) --> Entero largo

ParámetroTipoDescripción
**-->Si se especifica, lista es un nombre de objeto (cadena)
Si se omite, lista es un número de referencia de lista
listaRefLista | Cadena-->Número de referencia de lista (si se omite *) o
Nombre del objeto de tipo lista (si se pasa *)
**-->Si se omite (por defecto): Devuelve los elementos
visibles (desplegados) de la lista
Si se especifica: Devuelve todos los elementos de la lista
ResultadoEntero largoNú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.


4D - Documentation   Français   English   German   Español   English   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente