GET LIST ITEM PARAMETER

4D v16.3


GET LIST ITEM PARAMETER ( {* ;} lista ; refElem \| * ; selector ; valor )

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 la lista
lista	ListRef, Cadena	Número de referencia de lista (si se omite ) o Nombre del objeto de tipo lista (si se pasa )
refElem \| *	Entero largo, Operador	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
selector	Cadena	Constante del parámetro
valor	Cadena, Booleano, Real	Valor actual del parámetro

Descripción

El comando GET LIST ITEM PARAMETER permite conocer el valor actual del parámetro selector para el elemento refElem de la lista jerárquica cuya referencia o nombre de objeto se pasa en el parámetro 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 la 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 una sola representación de lista o trabaja con los elementos estructurales (se omite el segundo *), puede utilizar indiferentemente una u otra sintaxis. Por el contrario, si utiliza varias representaciones de una misma lista y se pasa el segundo *, es requerida la sintaxis basada en el nombre del objeto ya que cada representación puede tener su propio elemento actual.

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

Puede pasar un número de referencia en refElem. Si este número no corresponde a ningún elemento de la lista, el comando no hace nada. Igualmente puede pasar 0 en refElem para indicar el último elemento añadido a la lista (utilizando APPEND TO LIST).

Finalmente, puede pasar * en refElem: en este caso, el comando se aplicará al elemento actual de la lista. Si se seleccionan manualmente varios elementos, el elemento actual es el último seleccionado. Si ningún elemento fue seleccionado, el comando no hace nada.

En selector, puede pasar la constante Additional text (ubicada en el tema “Listas jerárquicas”) o cualquier valor personalizado. Para mayor información sobre los parámetros selector y valor, consulte la descripción del comando SET LIST ITEM PARAMETER.

Ver también

Listas jerárquicas
SET LIST ITEM PARAMETER