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 |
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
Propiedades
| Número de comando | 1727 |
| Hilo seguro | ✗ |
| Modifica variables | OK |