List item parent

versión 11 (Modificado)

List item parent ({*; }lista; refElem | *) Entero largo

El comando List item parent devuelve el número de referencia del elemento padre.

Pase en lista el número de referencia o el nombre de objeto de la 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 o trabaja con elementos estructurales (el segundo * se omite), puede utilizar indiferentemente una u otra sintaxis. Por el contrario, si utiliza varias representaciones de la misma lista y trabaja con el elemento actual (el segundo * es pasado), la sintaxis basada en el nombre del objeto es necesaria ya que cada representación tiene su propio elemento actual.

Nota: Si utiliza el carácter @ en el nombre del objeto de la lista y el formulario contiene varias listas que tienen este nombre, el comando List item parent se aplicará al primer objeto cuyo nombre corresponda.

Pase en refElem un número de referencia de elemento en la lista ó 0 ó *. Si pasa 0, el comando aplica al último elemento añadido a la lista. Si pasa *, el comando aplica el elemento actual de la lista. Si varios elementos han sido seleccionados manualmente, el elemento actual es el último elemento seleccionado.

En cambio, si el elemento correspondiente existe en la lista y si este elemento está en una sublista (y por lo tanto tiene un elemento padre), usted obtiene el número de referencia del elemento padre.

Si no existe un elemento con el número de referencia que pasó, o si pasó * y ningún elemento está seleccionado, o si el elemento no tiene padre, List item parent devuelve 0 (cero).

Si trabaja con números de referencia de los elementos, asegúrese de construir una lista en la cual los elementos tengan números de referencia únicos; de lo contrario no podrá diferenciar los elementos. Para mayor información, consulte la descripción del comando APPEND TO LIST.

He aquí una lista llamada hList mostrada en el entorno Aplicación:

Los números de referencia de los elementos son los siguientes:

• En el siguiente código, si el elemento, "b - 3" es seleccionado, la variable $vlPadreElemRef toma el valor 200, es decir el número de referencia del elemento "b":

   $vlItemPos:=Selected list items(hList)
   GET LIST ITEM(hList;$vlItemPos;$vlItemRef;$vsItemText)
   $vlPadreElemRef :=List item parent(hList;$vlItemRef) ` $vlPadreElemRef vale 200

• Si el elemento "a - 1" es seleccionado, la variable $vlPadreElemRef toma el valor 100, es decir el número de referencia del elemento "a".

• Si el elemento "a" o "b" es seleccionado, la variable $vlPadreElemRef toma el valor 0, porque estos elementos no tienen elemento padre.

GET LIST ITEM, List item position, SELECT LIST ITEMS BY REFERENCE, SET LIST ITEM.