FORM GET ENTRY ORDER

4D v20 R7


FORM GET ENTRY ORDER ( nomObjetos {; numPag \| * } )

Parámetro	Tipo	Descripción
nomObjetos	Array texto	Nombres de objetos ordenados por orden de entrada
numPag \| *	Entero largo, Operador	Número de la página para la que se obtiene el orden de entrada definido (página actual si se omite), o * para obtener el orden de entrada real de la página actual

Descripción

El comando FORM GET ENTRY ORDER devuelve en nomObjetos los nombres ordenados de los objetos que definen el orden de entrada del formulario.

Si no pasa el parámetro *, FORM GET ENTRY ORDER devuelve el orden de entrada como se declaró anteriormente con el comando FORM SET ENTRY ORDER. Puede omitir o pasar el parámetro numPag:
- Si omite el parámetro numPag, el array nomObjetos devuelve el orden de entrada para la página actual,
- Si pasa el parámetro numPag, el array nomObjetos devuelve el orden de entrada para la página numPag.
En ambos casos, si el comando FORM SET ENTRY ORDER no fue llamado previamente para el formulario actual, el array nomObjetos se devuelve vacío.

Si pasa el parámetro *, FORM GET ENTRY ORDER devuelve el orden de entrada actual de la página actual, es decir, el array nomObjetos sólo contiene nombres de objeto válidos ( (para más información sobre objetos válidos, consulte la descripción del comando FORM SET ENTRY ORDER). El orden de entrada de formulario real puede ser:
- El orden de entrada de formulario predeterminado, basado en la superposición de objetos,
- O el orden de entrada del editor de formularios (ver Modificar el orden de entrada de los datos), si se ha utilizado,
- O el orden de entrada definido por una llamada al comando FORM SET ENTRY ORDER en el proceso actual, si se ha utilizado.
El orden de entrada real siempre incluye objetos de la página 0 y de los formularios heredados.

Nota: el orden de entrada dentro de un subformulario no se devuelve cuando se aplica este comando al formulario padre.

Ejemplo

Puede excluir ciertos objetos del orden de entrada:

 ARRAY TEXT($arrTabOrderObject;0)

 C_LONGINT($vElem)

 

 FORM GET ENTRY ORDER($arrTabOrderObject;*) //obtener el orden de entrada actual

 Repeat

    $vElem:=Find in array($arrTabOrderObject;"vTax@")

    If($vElem>0) //excluye objetos cuyo nombre comienza por "vTax" del orden de entrada de datos

       DELETE FROM ARRAY($arrTabOrderObject;$vElem)

    End if

 Until($vElem<0)

 FORM SET ENTRY ORDER($arrTabOrderObject) //aplica el nuevo orden de entrada

Ver también

FORM SET ENTRY ORDER