WA Run offscreen area
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) |
| 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:
- 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
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