WA Run offscreen area

Home

4D v20.1


WA Run offscreen area ( parameters ) -> Funktionsergebnis

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

Beschreibung

Der Befehl WA Run offscreen area erstellt einen Web Bereich im Speicher, um Web Seiten automatisch zu laden und zu durchlaufen.

Hinweis: Dieser Befehl verwendet die eingebundene Web Rendering Engine.

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
url	Objekt Text \| Datei	URL oder Datei zum Laden in den Web Bereich. Ohne Angabe oder bei Null wird eine leere Seite geladen.
area	Text	Name des Web Bereichs. Ohne Angabe oder bei Null wird ein generischer Name zugewiesen (z.B. OffscreenArea1).
onEvent	Objekt	Callback-Methode, die gestartet wird, wenn der Web Bereich bereitsteht. Das kann entweder eine Function onEvent einer Klasse oder ein Objekt Formula sein Sie wird standardmäßig bei den Ereignissen On Load, On Unload, On End URL Loading, On Timer oder On URL Loading Error aufgerufen.
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 oder mit dem Objekt $4d aufgerufenen Projektmethoden die Befehle CANCEL oder ACCEPT verwenden, um den Web Bereich zu schließen.
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 zum Zurückgeben (falls vorhanden)
<customProperty>	mixed	Eigene Attribute für die Callback- oder $4d-Methode.

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.

Übergeben Sie in parameters einen Nullwert, wird ein leerer Web Bereich erstellt und dann automatisch geschlossen.

Hinweise:

Der offscreen Web Bereich ist nur während der Ausführung von WA Run offscreen area verfügbar. Er wird automatisch aufgehoben, wenn die Ausführung beendet ist.
4D Methoden lassen sich über den JavaScript Code in einem Web Bereich aufrufen. Siehe unter Zugriff auf 4D Methoden.

Folgende Befehle lassen sich in der Callback-Methode verwenden:

Beispiel

Einen offscreen Web Bereich mit einer Funktion Ihrer OffscreenArea class erstellen und verwalten:

 $config:=cs.OffscreenArea.new()

 $result:=WA Run offscreen area($config)

 If($config.timeoutReached) //automatically returned in case of timeout

    ALERT("Timeout reached")

 End if

In der OffscreenArea class:

 Class constructor

 This.url:=File("/RESOURCES/compute.html")

 This.area:="myWAOffscreen"

 

 Funktion onEvent

 Case of

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

       This.result:=WA Evaluate JavaScript(*;This.area;"myJSMethod();")

 End case

Systemvariablen und Mengen

Die Systemvariable OK wird auf 0 gesetzt, wenn das Timeout erreicht ist oder CANCEL in onEvent aufgerufen wird, sonst wird sie auf 1 gesetzt.

Siehe auch

FORM Event
WA OPEN WEB INSPECTOR
Web Areas per Programmierung verwalten