SELECT LIST ITEMS BY POSITION

versión 11 (Modificado)

SELECT LIST ITEMS BY POSITION ({*; }lista; posicionElem{; posicionArray})

El comando SELECT LIST ITEMS BY POSITION selecciona el(los) elemento(s) cuya posición se pasa en posicionElem y, opcionalmente, en posicionArray 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, 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.

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 SELECT LIST ITEMS BY POSITION sólo aplicará al primer objeto cuyo nombre corresponde.

La posición de los elementos siempre se expresa utilizando el estado desplegado/contraído de la lista y sus sublistas. Usted pasa un valor de posición entre 1 y el valor devuelto por Count list items. Si pasa un valor fuera de este rango, no se selecciona ningún elemento.

Si no pasa el parámetro posicionArray, el parámetro posicionElem representa la posición del elemento a seleccionar.

El parámetro opcional posicionArray le permite seleccionar varios elementos simultáneamente de la lista. En posicionArray, debe pasar un array donde cada línea indique la posición de un elemento a seleccionar.

Cuando pasa este parámetro, el elemento designado por el parámetro posicionElem designa el nuevo elemento actual de la lista en la selección resultante, el cual puede pertenecer o no al conjunto de elementos definido por el array. El elemento actual es, más particularmente, el que pasa a modo edición si se utiliza el comando EDIT ITEM.

Nota: Para que varios elementos puedan ser seleccionados simultáneamente en una lista jerárquica (manualmente o por programación), la propiedad multi-seleccionable debe haber sido activada para la lista. Esta propiedad se define utilizando el comando SET LIST PROPERTIES.

Dada la lista jerárquica llamada hList, mostrada en el entorno Aplicación:

1. Después de la ejecución de este código:

   SELECT LIST ITEMS BY POSITION(hList;Count list items(hList))
   

El último elemento visible de la lista es seleccionado:

2. Después de la ejecución de las siguientes líneas de código:

   SET LIST PROPERTIES(hList;0;0;18;0;1)
      `Es imperativo pasar 1 como último parámetro para permitir las selecciones múltiples
   ARRAY LONGINT($arr;3)
   $arr{1}:=2
   $arr{2}:=3
   $arr{3}:=5
   SELECT LIST ITEMS BY POSITION(hList;3;$arr)
      `El tercer elemento se designa como elemento actual
   

... los elementos segundo, tercero y quinto de la lista jerárquica son seleccionados:

EDIT ITEM, SELECT LIST ITEMS BY REFERENCE, Selected list items.