WA Run offscreen area

4D v19.8


WA Run offscreen area ( parâmetro ) -> Resultado

Parâmetro	Tipo	Descrição
parâmetro	Objeto	Objeto que contém os atributos da área web
Resultado	Mixed	Valor retornado pelo método de callback

Descrição

O comando WA Run offscreen area cria uma área web na memória que pode ser usada para carregar automaticamente e analisar as páginas web

Nota: Esse comando usa o motor de renderização web embebido. .

No objeto parâmetros, pasesqualquer dos atributos opcionais abaixo para a área web. Estas propiedades estarão disponíveis através do comando This dentro do método onEvent e fazem referência à instância:

Propriedade	Tipo	Descrição
url	text \| file object	A URL ou arquivo a ser carregado na área web. Se omitido ou null, uma página em branco é carregada.
areaName	text	O nome da área web. Se omitido ou null, um nome genérico é atribuido (por exemplo, OffscreenArea1).
onEvent	object	Um método de callback que será lançado quando a área web estiver pronta. Como padrão, o método de callback é chamado nos eventos On Load, On Unload, On End URL Loading, On Timer ou On URL Loading Error.
autoQuit	boolean	True (valor normal) se o comando precisar parar a execução da fórmula quando acontecerem os eventos On End URL Loading ou On URL Loading Error. Se false, precisa usar os comandos CANCEL ou ACCEPT no método de callback ou nos métodos projeto chamados com o objeto $4d para fechar a área web.
timeout	real	Tempo máximo permitido (expresso em segundos) entre chamadas de evento. Se estabelecida em 0, nenhum limite é aplicado. Valor padrão: 60
result	mixed	Resultado do processamento a retornar (se houver)
<customProperty>	mixed	Qualquer atributo personalizado vai estar disponível na callback ou no método $4d.

O comando agrega automaticamente a propriedade abaixo se for necessário:

Propriedade	Tipo	Descrição
timeoutReached	booleano	Adiciona valor true se timeout foi excedido

Se passar um valor nulo em parâmetros, será criada uma área web em branco e depois se fechará automaticamente.

Notas:

A área web offscreen está disponível apenas durante a execução do comando WA Run offscreen area. Vai ser destruida automaticamente quando a execução tiver terminado.
Métodos 4D podem ser chamados a partir do código JavaScript executado na área web. Veja Acessar aos métodos 4D.

Os comandos abaixo podem ser usados no método callback:

Exemplo

Se quiser criar e manejar uma área web offscreen usando uma função da classe OffscreenArea:

 $config:=cs.OffscreenArea.new()

 $result:=WA Run offscreen area($config)

 If($config.timeoutReached) //automaticamente retornado em caso de timeout

    ALERT("Timeout reached")

 End if

Na classe OffscreenArea:

 Class constructor

 This.url:=File("/RESOURCES/compute.html")

 This.areaName:="myWAOffscreen"

 

 Function onEvent

 Case of

    :(FORM Event.code=On End URL Loading)

       This.result:=WA Evaluate JavaScript(*;This.areaName;"myJSMethod();")

 End case

Variáveis e conjuntos do sistema

A variável de sistema OK é estabelecida como 0 se o timeout foi alcançaddo ou CANCEL for chamado em onEvent, senão é estabelecida como 1.

Ver também

FORM Event
Gestão programada de áreas web
WA OPEN WEB INSPECTOR