VP Run offscreen area

4D v19


VP Run offscreen area ( parâmetros ) -> Resultado

Parâmetro	Tipo	Descrição
parâmetros	Objeto	Objeto contendo os atributos de área offscreen
Resultado	Mixed	propriedade .result do objeto onEvent, ou Null se não retornar um valor

Descrição

O comandoVP Run offscreen area cria uma área offscreen na memória que pode ser usada para processar os comandos e funções da área 4D View Pro.

No objeto parametros, passe qualquer uma das propriedades opcionais abaixo. Estas propriedades estarão disponíveis através do comando This dentro do método onEvent e referencia a instância:

Propriedade	Tipo	Descrição
area	text	O nome da área offscreen. Se omitido ou null, um nome genérico é atribuído (por exemplo, OffscreenArea1).
onEvent	object (formula)	Um método callback que será lançado quando a área offscreen estiver vazia. Pode ser: uma função onEvent de uma classe ou um objeto Formula Normalmente o método callback é chamado nos eventos On VP Ready, On Load, On Unload, On End URL Loading, On URL Loading Error ou On VP Range Changed. . O método callback pode ser usado para acessar o objeto 4D View Pro. Veja Variável objeto formulário 4D View Pro.
autoQuit	boolean	True (valor normal) se o comando dever parar a execução da fórmula quando os eventos On End URL Loading ou On URL Loading Error acontecerem. Se false, deve usar os comandos CANCEL ou ACCEPT no método de callback onEvent.
timeout	real	Tempo máximo (em segundos) antes que a área feche automaticamente se nenhum evento for gerado. Se estabelecido em 0, nenhum limite é aplicado. Valor padrão: 60
result	mixed	Resultado do processamento (se houver)
<customProperty>	mixed	Qualquer atributo personalizado a estar disponível no método de callback onEvent.

A propriedade abaixo é adicionada automaticamente pelo comando se necessário:

Propriedade	Tipo	Descrição
timeoutReached	boolean	Adiciona com valor true se timeout tiver sido excedido

Nota: A área offscreen só está disponível durante a execução do comando VP Run offscreen area. Será automaticamente destruido quando a execução terminar.

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

    ACCEPT
    CANCEL
    SET TIMER
    WA Evaluate JavaScript
    WA EXECUTE JAVASCRIPT FUNCTION

Exemplo 1

Se quiser criar uma área offscreen 4D View Pro e obter o valor de uma célula:

 <br/> // Declaração classe OffscreenArea <br />Class constructor <br />C_TEXT($1) <br />This.filePath:=$1<br /><br />// Esta função será chamada a cada evento na área offscreen <br />Function onEvent<br />Case of :(FORM Event.code=On VP Ready)<br />VP IMPORT DOCUMENT (This.area;This.filePath)<br />This.result:=VP Get value (VP Cell (This.area;6;22)) <br /><br />ALERT("A célula G23 contém o valor: "+String(This.result)) <br />End case

o método de callback OffscreenArea:

 $o:=cs.OffscreenArea.new()&NBSP; $result:=VP Run offscreen area($o) 

Exemplo 2

Se quiser carregar um grande documento offscreen, espere que se avaliem todos os cálculos e exporte para um PDF:

 <br/> //declaração classe OffscreenArea<br />class constructor($pdfPath : Text)<br />This.pdfPath:=$pdfPath<br />This.autoQuit:=False<br />This.isWaiting:=False<br /><br />Function onEvent<br />Case of <br />:(FORM Event.code=On VP Ready)<br /> // Importar Documento<br />VP IMPORT DOCUMENT(This.area; $largeDocument4VP)<br />This.isWaiting:=True <br /><br />// Inicia um timer para verificar se todos os cálculos terminaram.<br />// Se durante esse período o "On VP Range Changed" é ativado, o timer é reiniciado<br />// A hora deve ser definida de acordo com a configuração do computador.<br />SET TIMER(60)<br /><br />:(FORM Event.code=On VP Range Changed)<br />// Final do cálculo detectado. Reinicia o timer<br />If (This.isWaiting)<br />SET TIMER(60)<br />End if<br /><br />:(FORM Event.code=On Timer)<br />// Assegura que não reinicia o timer se chamar outros comandos 4D View depois desse ponto<br />This.isWaiting:=False<br /><br />// Para o timer<br />SET TIMER(0)<br /><br />// Inicia a exportação PDF<br />VP EXPORT DOCUMENT(This.area; This.pdfPath; New object("formula"; Formula(ACCEPT)))<br /><br />:(FORM Event.code=On URL Loading Error)<br />CANCEL<br />End case<br />

o método de callback OffscreenArea:

 $o:=cs.OffscreenArea.new() $result:=VP Run offscreen area($o) 

Ver também