GET LIST ITEM

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)


GET LIST ITEM (*; lista; posicionElem  | *; refElem; textoElem{; sublista{; desplegada}})

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 | CadenaNúmero de referencia de lista (si se omite *) o
Nombre del objeto de tipo lista (si se pasa *)
posicionElem  | *Numérico | *Posición del elemento en lista(s) desplegada(s) o
contraída(s)
* para el elemento actual de la lista.
refElemEntero largoNúmero de referencia del elemento
textoElemAlfaTexto del elemento de la lista
sublistaListRefNúmero de referencia de la sublista (si la hay)
desplegadaBooleanoSi una sublista está asociada:
TRUE = la sublista está desplegada
FALSE = la sublista está contraída

Descripción

El comando GET LIST ITEM devuelve la información sobre el elemento especificado por posicionElem de 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, indica que el parámetro lista es una referencia de lista jerárquica (RefLista). Si utiliza sólo una representación de lista, puede utilizar indiferentemente una u otra sintaxis. Por el contrario, si usted utiliza varias representaciones de una misma lista, la lista basada en el nombre del objeto es necesaria ya que cada representación puede tener su propia configuración desplegada/contraída y su propio elemento actual.

Nota: si utiliza el carácter @ en el nombre de la lista y el formulario contiene varias listas que responden a este nombre, el comando GET LIST ITEM sólo aplicará al primer objeto cuyo nombre corresponda.

La posición debe expresarse respecto al estado actual desplegado/contraído de la lista y de su sublista. Debe pasar un valor de posición entre 1 y el valor devuelto por Count list items. Si pasa un valor que no está en este rango, GET LIST ITEM devuelve valores vacíos (0, "", etc.).

Después de la llamada, recupera:

El número de referencia del elemento en refElem.

El texto del elemento en textElem.

Si pasa los parámetros opcionales sublista y desplegada:

subLista devuelve el número de referencia de la sublista asociada al elemento. Si el elemento no tiene sublista, subLista devuelve cero (0).

Si el elemento tiene una sublista, desplegada devuelve TRUE si la sublista está desplegada, y FALSE si está contraída.

Ejemplos

1. hList es una lista cuyos elementos tienen números de referencia únicos. El siguiente código pasa por programación al estado desplegado/contraído de la sublista, si hay, asociada al elemento seleccionado:

   $vlItemPos:=Selected list items(hList)
   If ($vlItemPos>0)
      GET LIST ITEM(hList;$vlItemPos;$vlItemRef;$vsItemText;$hSublist;$vbDesplegada)
      If (Is a list($hSublist))
         SET LIST ITEM(hList;$vlItemRef;$vsItemText;$vlItemRef;$hSublist;Not($vbDesplegada))
      End if 
   End if 

2. Consulte el ejemplo del comando APPEND TO LIST.

Ver también

GET LIST ITEM PROPERTIES, List item parent, List item position, Selected list items, SET LIST ITEM, SET LIST ITEM PROPERTIES.


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