GET LIST ITEM

versión 11 (Modificado)

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

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 usted 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.

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.

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