GET LIST ITEM PARAMETER

4D - Documentation   Français   English   German   Español   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente

versión 11


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

ParámetroTipoDescripción
**Si se especifica, lista es un nombre de objeto (cadena)
Si se omite, lista es un número de referencia de la
lista
listaRefLista | CadenaNúmero de referencia de lista (si se omite *) o
Nombre del objeto de tipo lista (si se pasa *)
refElem | *Ent. 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
selectorCadenaConstante del parámetro
valorCadena | Booleano | NumValor 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, por favor consulte la descripción del comando SET LIST ITEM PARAMETER.

Ver también

SET LIST ITEM PARAMETER.


4D - Documentation   Français   English   German   Español   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente