Saltar para o conteúdo principal
Versão: Próximo

WA Run offscreen area

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

ParâmetroTipoDescrição
parâmetroObjectObjeto que contém os atributos da área web
ResultadoanyValor retornado pelo método de callback

Esse comando não é seguro para thread e não pode ser usado em código adequado.

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
urltext | file objectA URL ou arquivo a ser carregado na área web. Se omitido ou null, uma página em branco é carregada.
areaNametextO nome da área web. Se omitido ou null, um nome genérico é atribuido (por exemplo, OffscreenArea1).
onEventobjectUm 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.
autoQuitbooleanTrue (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.
timeoutrealTempo máximo permitido (expresso em segundos) entre chamadas de evento. Se estabelecida em 0, nenhum limite é aplicado. Valor padrão: 60
resultmixedResultado do processamento a retornar (se houver)
mixedQualquer 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
TipoDescrição
timeoutReachedbooleanoAdiciona 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