VP Run offscreen area

Home

4D v19


VP Run offscreen area ( parameters ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
parameters	Objekt	Objekt mit den Attributen des offscreen Bereichs
Funktionsergebnis	Mixed	Eigenschaft .result des Objekts onEvent oder Null, wenn kein Wert zurückgegeben wird

Beschreibung

Der Befehl VP Run offscreen area erstellt einen offscreen Bereich im Speicher zum Ausführen von Befehlen und Funktionen des 4D View Pro Bereichs.

Im Objekt parameters übergeben Sie eine der folgenden optionalen Eigenschaften. Sie sind in der Methode onEvent über den Befehl This verfügbar und verweisen auf die Instanz:

Eigenschaft	Typ	Beschreibung
area	Text	Name des offscreen Bereichs. Ohne Angabe oder bei Null wird ein generischer Name zugewiesen (z.B. OffscreenArea1).
onEvent	Objekt (Formel)	Callback-Methode, die gestartet wird, wenn der offscreen Bereich bereitsteht. Das kann folgendes sein: eine onEvent Funktion einer Class oder ein Objekt Formula Sie wird standardmäßig bei den Ereignissen On VP Ready, On Load, On Unload, On End URL Loading, On URL Loading Error oder On VP Range Changed aufgerufen. Über die Callback-Methode können Sie auf das Objekt 4D View Pro zugreifen. Weitere Informationen dazu finden Sie im Abschnitt Objektvariable des 4D View Pro Formulars.
autoQuit	Boolean	Wahr (Standardwert), wenn der Befehl bei Auftreten vom Ereignis On End URL Loading oder On URL Loading Error die Ausführung der Formel stoppen muss. Bei Falsch müssen Sie in der Callback-Methode onEvent den Befehl CANCEL oder ACCEPT verwenden.
timeout	Zahl	Maximal zugelassene Zeit (in Sekunden) bis zum automatischen Schließen des Bereichs, wenn kein Ereignis generiert wird. Ist der Wert 0, gibt es keine Beschränkung. Standardwert: 60
result	mixed	Ergebnis der Bearbeitung (falls zutreffend)
<customProperty>	mixed	Eigene Attribute für die Callback-Methode onEvent

Der Befehl fügt bei Bedarf automatisch folgende Eigenschaft hinzu:

Eigenschaft	Typ	Beschreibung
timeoutReached	Boolean	Wird bei Überschreitung des Timeout mit dem Wert Wahr hinzugefügt.

Hinweis: Der offscreen Bereich ist nur während der Ausführung von VP Run offscreen area verfügbar. Er wird automatisch aufgehoben, wenn die Ausführung beendet ist.

Folgende Befehle lassen sich in der Callback-Methode verwenden:

Beispiel 1

Einen offscreen 4D View Pro Bereich erstellen und den Wert einer Zelle erhalten:

  // OffscreenArea class declaration 

 Class constructor

 C_TEXT($1)&nbsp;

 This.filePath:=$1

 

  // Diese Funktion wird bei jedem Ereignis des offscreen Bereichs aufgerufen

 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

Die Callback-Methode OffscreenArea lautet:

 $o:=cs.OffscreenArea.new()

 

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

Beispiel 2

Ein umfangreiches Dokument offscreen laden, Ausführen aller Berechnungen abwarten und dann als PDF exportieren:

  //OffscreenArea class declaration

 class constructor($pdfPath Text)

 This.pdfPath:=$pdfPath

 This.autoQuit:=False

 This.isWaiting:=False

 

 Function onEvent

 Case of

    :(FORM Event.code=On VP Ready)

  // Document import

       VP IMPORT DOCUMENT(This.area;$largeDocument4VP)

       This.isWaiting:=True

 

  // Einen Timer zum Prüfen starten, ob alle Berechnungen beendet sind.

  // Wird während dieser Zeitspanne "On VP Range Changed" ausgeworfen, startet der Timer erneut

  // Die Zeit muss gemäß der Konfiguration des Rechners definiert werden.

       SET TIMER(60)

 

    :(FORM Event.code=On VP Range Changed)

  // Ende der Berechnung wurde festgestellt. Startet den Timer neu

       If(This.isWaiting)

          SET TIMER(60)

       End if

 

    :(FORM Event.code=On Timer)

  // Zum Sicherstellen, dass der Timer nicht neu startet, wenn Sie nach diesem Punkt andere 4D View Befehle aufrufen.

       This.isWaiting:=False

 

  // Timer stoppen

       SET TIMER(0)

 

  // PDF Export starten

       VP EXPORT DOCUMENT(This.area;This.pdfPath;New object("formula";Formula(ACCEPT)))

 

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

       CANCEL

 End case

Die Callback-Methode OffscreenArea lautet:

 $o:=cs.OffscreenArea.new()

 

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

Siehe auch

Blog post: End of document loading