List item parent

4D v20 R7

List item parent


List item parent ( {* ;} lista ; refElem \| * ) -> Resultado

Parámetro	Tipo	Descripción
*	Operador	Si se especifica, lista es un nombre de objeto (cadena) Si se omite, lista es un número de referencia de lista
lista	ListRef, Cadena	Número de referencia de la lista (si se omite ), o Nombre de objeto de tipo lista (si se pasa)
refElem \| *	Operador, Entero largo	Número de referencia del elemento o 0 para el último elemento añadido a la lista o * para el elemento actual de la lista
Resultado	Entero largo	Número de referencia del elemento padre o 0 si no hay

Descripción

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.

Ejemplo

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

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

Elemento	Número
a	100
a - 1	101
a - 2	102
a - 3	103
b	200
b - 1	201
b - 2	202
b - 3	203

En el siguiente código, si se selecciona el elemento “b - 3”, 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 se selecciona el elemento “a - 1”, la variable $vlPadreElemRef toma el valor 100, es decir el número de referencia del elemento “a”.
Si se selecciona el elemento el elemento “a” o “b”, la variable $vlPadreElemRef toma el valor 0, porque estos elementos no tienen elemento padre.

Ver también

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