Saltar al contenido principal
Versión: 20 R6 BETA

VP Run offscreen area

VP Run offscreen area ( parameters : Object) : Mixed

ParámetrosTipoDescripción
parametersObject->Objeto que contiene los atributos del área fuera de pantalla
ResultMixed<-propiedad .result del objeto .onEvent, o Null si no devuelve ningún valor

Descripción

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

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

PropiedadTipoDescripción
areatextEl nombre del área fuera de la pantalla. Si se omite o es null, se asigna un nombre genérico (por ejemplo, "OffscreenArea1").
onEventobjet (fórmula)Un método retro llamada que se lanzará cuando el área fuera de la pantalla esté lista. It can be either:
  • an onEvent function of a class, or
  • a Formula object
  • By default, the callback method is called on the On VP Ready, On Load, On Unload, On End URL Loading, On URL Loading Error, On VP Range Changed, or On Timer events. El método de retrollamada puede ser utilizado para acceder a la variable del objeto 4D View Pro.
    autoQuitbooleanTrue (default value) if the command must stop the formula execution when the On End URL Loading or On URL Loading Error events occur. Si es false, debe utilizar los comandos CANCEL o ACCEPT en el método de retrollamada onEvent.
    timeoutnumberTiempo máximo (expresado en segundos) antes de que el área se cierre automáticamente si no se genera ningún evento. Si se fija en 0, no se aplica ninguna limitación. Valor por defecto: 60
    resultadomixtoResultado del procesamiento (si hay)
    <customProperty>mixtoTodo atributo personalizado que esté disponible en el método de retrollamada onEvent.

    La siguiente propiedad es añadida automáticamente por el comando si es necesario:

    PropiedadTipoDescripción
    timeoutReachedbooleanAñadido con el valor true si se ha excedido el tiempo de espera

    El área fuera de pantalla solo está disponible durante la ejecución del comando VP Run offscreen area. Se destruirá automáticamente una vez finalizada la ejecución.

    Los siguientes comandos se pueden utilizar en el método de retrollamada:

    • ACCEPT
    • CANCEL
    • SET TIMER
    • WA Evaluate JavaScript
    • WA EXECUTE JAVASCRIPT FUNCTION

    Ejemplo 1

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

    // Declaración de la clase cs.OffscreenArea 
    Class constructor ($path : Text)
    This.filePath:=$path

    // Esta función será llamada en cada evento del área offscreen
    Function onEvent()
    Case of
    :(FORM Event.code=On VP Ready)
    VP IMPORT DOCUMENT(This.area;This.filePath)
    This.result:=VP Get value(VP Cell(This.area;6;22))

    ALERT("The G23 cell contains the value: "+String(This.result))
    End case

    El método de retrollamada OffscreenArea:

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

    Ejemplo 2

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

    // Declaración de clase cs.OffscreenArea
    Class constructor($pdfPath : Text)
    This.pdfPath:=$pdfPath
    This.autoQuit:=False
    This.isWaiting:=False

    Function onEvent()
    Case of
    :(FORM Event.code=On VP Ready)
    // Importar el documento
    VP IMPORT DOCUMENT(This.area;$largeDocument4VP)
    This.isWaiting:=True

    // Iniciar un temporizador para verificar si todos los cálculos han finalizado.
    // Si durante este período se lanza "On VP Range Changed", se reiniciará el temporizador
    // El tiempo debe ser definido de acuerdo con la configuración del ordenador.
    SET TIMER(60)

    :(FORM Event.code=On VP Range Changed)
    // Se detectó el fin del cálculo. Reinicia el temporizador
    If(This.isWaiting)
    SET TIMER(60)
    End if

    :(FORM Event.code=On Timer)
    // Para asegurarse de no reiniciar el temporizador si llama a otros comandos de 4D View después de este punto
    This.isWaiting:=False



    // Detener el temporizador
    SET TIMER(0)

    // Iniciar la exportación a PDF
    VP EXPORT DOCUMENT(This.area;This.pdfPath;New object("formula";Formula(ACCEPT)))

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

    CANCEL
    End case

    El método de retrollamada OffscreenArea:

    $o:=cs.OffscreenArea.new()

    $result:=VP Run offscreen area($o)

    Ver también

    Blog post: End of document loading