Saltar al contenido principal
Versión: Siguiente

WA Run offscreen area

WA Run offscreen area ( parametros ) -> Resultado

ParámetroTipoDescripción
parametrosObjectObjeto que contiene los atributos del área web
ResultadoanyPropiedad .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:

PropiedadTipo
Descripción
urltexto | objeto de archivoLa URL o el archivo que se cargará en el área web. Si se omite o es null, se carga una página en blanco.
areatextoEl nombre del área web. Si se omite o es null, se asigna un nombre genérico (por ejemplo, OffscreenArea1).
onEventobjeto (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.
autoQuitbooleanoTrue (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.
timeoutrealTiempo 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
resultfusionadoResultado del proceso a devolver (si lo hay)
fusionadoTodo atributo personalizado que esté disponible en la retrollamada o método $4d.

El comando agrega automáticamente la siguiente propiedad si es necesario:

PropiedadTipo
Descripción
timeoutReachedbooleanoAgregado 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:

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