Saltar al contenido principal
Versión: Siguiente

GET LIST ITEM PARAMETER

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

ParámetroTipoDescripción
*OperadorSi se especifica, lista es un nombre de objeto (cadena) Si se omite, lista es un número de referencia de la lista
listaInteger, TextNúmero de referencia de lista (si se omite *) o Nombre del objeto de tipo lista (si se pasa *)
refElem | *Entero largo, OperadorNúmero de referencia del elemento o 0 para el último elemento añadido a la lista o * para el elemento actual de la lista
selectorTextConstante del parámetro
valorText, Boolean, RealValor actual del parámetro

Este comando no es hilo seguro, no puede ser utilizado en código apropiativo.

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 o Standard action (en el tema “Listas jerárquicas”) o todo 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