VP Run offscreen area

4D v19


VP Run offscreen area ( parametros ) -> Resultado

Parámetro	Tipo	Descripción
parametros	Objeto	Objeto que contiene los atributos del área fuera de pantalla
Resultado	Mixed	Propiedad .result del objeto onEvent, o Null si no devuelve un valor

Descripción

El comando VP Run offscreen area crea un área fuera de pantalla en la memoria que puede utilizarse para procesar comandos y funciones del área 4D View Pro.

En el objeto parametros, pase cualquiera de las siguientes propiedades opcionales. Estas propiedades estarán disponibles a través del comando This dentro del método onEvent y hacen referencia a la instancia:

Propiedad	Tipo	Descripción
area	texto	El nombre del área fuera de pantalla. Si se omite o es nulo, se asigna un nombre genérico (por ejemplo, OffscreenArea1).
onEvent	objeto (fórmula)	Un método de retrollamada que se iniciará cuando el área fuera de pantalla 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 VP Ready, On Load, On Unload, On End URL Loading, On URL Loading Error, On VP Range Changed o On Timer. El método de retrollamada se puede utilizar para acceder al objeto 4D View Pro. Ver Variable objeto de formulario de 4D View Pro.
autoQuit	booleano	True (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 onEvent.
timeout	real	Tiempo máximo (expresado en segundos) antes de que el área se cierre automáticamente si no se genera ningún evento. Si se define en 0, no se aplica ninguna limitación. Valor predeterminado: 60
result	fusionado	Resultado del proceso (si lo hay)
<customProperty>	fusionado	Todo atributo personalizado que esté disponible en el método de retrollamada onEvent.

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

Propiedad	Tipo	Descripción
timeoutReached	booleano	Agregado con valor true si se ha excedido el tiempo de espera

Nota: el área fuera de pantalla solo está disponible durante la ejecución del comando VP Run offscreen area. Se destruirá automáticamente una vez que la ejecución haya finalizado.

En el método de retrollamada se pueden utilizar los siguientes comandos:

Ejemplo 1

Desea crear un área 4D View Pro fuera de la pantalla y obtener el valor de una celda:

 <br/> // Declaración de clase OffscreenArea<br />Class constructor <br />C_TEXT($1) <br />This.filePath:=$1<br /><br />// Esta función se llamará en cada evento del área fuera de pantalla<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("The G23 cell contains the value: "+String(This.result)) <br />End case

el método de retrollamada OffscreenArea:

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

Ejemplo 2

Quiere cargar un documento grande fuera de la pantalla, esperar a que todos los cálculos terminen de evaluarse y exportarlo como un PDF:

 <br/> //Declaración de clase OffscreenArea<br />class constructor($pdfPath : Text)<br />This.pdfPath:=$pdfPath<br />This.autoQuit:=False<br />This.isWaiting:=False<br /><br />Función onEvent<br />Case of <br />:(FORM Event.code=On VP Ready)<br /> // Importación de documentos<br />VP IMPORT DOCUMENT(This.area; $largeDocument4VP)<br />This.isWaiting:=True <br /><br />// Inicie un temporizador para verificar si todos los cálculos han terminado.<br />// Si durante este periodo se lanza "On VP Range Changed", el temporizador se reiniciará<br />// El tiempo debe ser definido según la configuración del ordenador.<br />SET TIMER(60)<br /><br />:(FORM Event.code=On VP Range Changed)<br />// Fin del cálculo detectado. Reinicia el temporizador<br />If (This.isWaiting)<br />SET TIMER(60)<br />End if<br /><br />:(FORM Event.code=On Timer)<br />// Para asegurarse de no reiniciar el temporizador si llama a otros comandos 4D View después de este punto<br />This.isWaiting:=False<br /><br />// Detener el temporizador<br />SET TIMER(0)<br /><br />// Iniciar la exportación en 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 />

El método de retrollamada OffscreenArea:

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

Ver también