WA Run offscreen area
WA Run offscreen area ( parametros ) : any
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| parametros | Object | → | Objeto que contiene los atributos del área web |
| Resultado | any | ← | Propiedad .result del objeto onEvent, o Null si no devuelve un valor |
Este comando no es hilo seguro, no puede ser utilizado en código apropiativo.
Descripción
El comando WA Run offscreen area crea un área web en memoria que se puede utilizar para cargar y analizar automáticamente las páginas web.
Nota: este comando utiliza el motor de renderización web integrado.
En el objeto parametros, pase cualquiera de los siguientes atributos opcionales. Estas propiedades estarán disponibles a través del comando This dentro del método onEvent y hacen referencia a la instancia:
| Propiedad | Tipo | Descripción |
|---|---|---|
| url | texto | objeto de archivo | La URL o el archivo que se cargará en el área web. Si se omite o es null, se carga una página en blanco. |
| area | texto | El nombre del área web. Si se omite o es null, se asigna un nombre genérico (por ejemplo, OffscreenArea1). |
| onEvent | objeto (fórmula) | Un método de retrollamada que se iniciará cuando el área web esté lista. Puede ser: una función onEvent de una clase, o un objeto Formula Por defecto, el método de retrollamada se llama en los eventos On Load, On Unload, On End URL Loading, On URL Loading Error o On Timer. |
| autoQuit | booleano | True (valor predeterminado) si el comando debe detener la ejecución de la fórmula cuando se producen los eventos On End URL Loading o On URL Loading Error. Si es false, debe utilizar los comandos CANCEL o ACCEPT en el método de retrollamada o métodos proyecto llamados con el objeto $4d para cerrar el área web. |
| timeout | real | Tiempo máximo (expresado en segundos) antes de que el área se cierre automáticamente si ningún evento se genera. Si se define en 0, no se aplica ninguna limitación. Valor predeterminado: 60 |
| result | fusionado | Resultado del proceso a devolver (si lo hay) |
| fusionado | Todo atributo personalizado que esté disponible en la retrollamada o método $4d. |
El comando agrega automáticamente la siguiente propiedad si es necesario:
| Propiedad | Tipo | Descripción |
|---|---|---|
| timeoutReached | booleano | Agregado con valor true si se ha excedido el tiempo de espera |
Si se pasa un valor nulo en parametros, se creará un área web en blanco y luego se cerrará automáticamente.
Notas:
- El área web fuera de pantalla solo está disponible durante la ejecución del comando WA Run offscreen area. Se destruirá automáticamente una vez haya finalizado la ejecución.
- Los métodos 4D pueden llamarse desde el código JavaScript ejecutado en un área web. Ver Acceder a los métodos 4D.
Los siguientes comandos se pueden usar en el método de retrollamada:
- ACCEPT
- CANCEL
- SET TIMER
- WA Evaluate JavaScript
- WA EXECUTE JAVASCRIPT FUNCTION
- WA Get current URL
- WA GET LAST URL ERROR
- WA Get page content
- WA Get page title
- WA OPEN URL
- WA REFRESH CURRENT URL
- WA STOP LOADING URL
Ejemplo
Desea crear y manejar un área web fuera de pantalla utilizando una función de su clase OffscreenArea:
$config:=cs.OffscreenArea.new()
$result:=WA Run offscreen area($config)
If($config.timeoutReached) //devuelto automáticamente en caso de tiempo de espera
ALERT("Timeout reached")
End if
En la clase OffscreenArea:
Class constructor
This.url:=File("/RESOURCES/compute.html")
This.area:="myWAOffscreen"
Function onEvent
Case of
:(FORM Event.code=On End URL Loading)
This.result:=WA Evaluate JavaScript(*;This.area;"myJSMethod();")
End case
Variables y conjuntos del sistema
La variable del sistema OK se define en 0 si se ha alcanzado el tiempo de espera o se ha llamado a CANCEL en onEvent, de lo contrario, se define en 1.
Ver también
FORM Event
Gestión programada de áreas web
WA OPEN WEB INSPECTOR