WA Démarrer hors écran

4D v20.6


WA Démarrer hors écran ( paramètres ) -> Résultat

Paramètre	Type	Description
paramètres	Objet	Objet contenant les attributs de la zone web
Résultat	Varié	Valeur retournée par la méthode callback (ou méthode de rétro-appel)

Description

La commande WA Démarrer hors écran crée une zone web dans la mémoire qui peut être utilisée pour charger et parser automatiquement des pages web.

Note : Cette commande utilise le moteur de rendu web intégré.

Dans l'objet paramètres, passez l'un des propriétés optionnelles suivantes pour la zone web. Ces propriétés seront disponibles via la commande This dans la méthode onEvent et référencent cette instance :

Propriété	Type	Description
url	objet texte \| fichier	L'URL ou le fichier à charger dans la zone web. S'il est omis, une page blanche est chargée.
area	texte	Le nom de la zone web. S'il est omis ou null, un nom générique est attribué (ex : OffscreenArea1).
onEvent	objet (formule)	Une méthode callback qui est lancée lorsque la zone web est prête. Elle peut être soit : une fonction onEvent d'une classe, ou un objet Formule Par défaut, la méthode callback est appelée sur les événements Sur chargement, Sur libération, Sur fin chargement URL, Sur erreur chargement URL, ou Sur minuteur.
autoQuit	booléen	Vrai (valeur par défaut) si la commande doit stopper l'exécution de la formule lorsque les événement Sur fin chargement URL ou Sur erreur chargement URL se produisent. Si faux, vous devez utiliser les commandes NE PAS VALIDER ou VALIDER dans la méthode callback ou les méthodes projet appelées avec l'objet $4d pour fermer la zone web.
timeout	réel	Durée maximale (en secondes) avant la fermeture automatique de la zone, si aucun événément n'est généré. Si elle est définie sur 0, aucune limitation n'est appliquée. Valeur par défaut : 60
result	mixte	Résultat du traitement à retourner (le cas échéant)
<customProperty>	mixte	Un attribut personnalisé disponible dans la méthode callback ou $4d.

La propriété suivante est automaiquement ajoutée par la commande, si nécessaire :

Propriété	Type	Description
timeoutReached	booléen	Ajoutée avec la valeur true si le timeout s'est écoulé

Si une valeur null est passée dans paramètres, une zone web vide sera créée puis automatiquement fermée.

Notes :

La zone web hors écran est disponible uniquement durant l'exécution de la commande WA Démarrer hors écran. Elle sera automatiquement détruite une fois que l'exécution est terminée.
Les méthodes 4D peuvent être appelées avec le code JavaScript qui est exécuté dans une zone web. Voir Accéder aux méthodes 4D.

Les commandes suivantes peuvent être utilisées dans la méthode callback :

Exemple

Vous souhaitez créer et gérer une zone web hors écran à l'aide d'une fonction de votre classe OffscreenArea :

 $config:=cs.OffscreenArea.new()

 $result:=WA Démarrer hors écran($config)

 Si($config.timeoutReached) //retourné automatiquement en cas de timeout

    ALERTE("Timeout écoulé")

 Fin de si

dans la classe OffscreenArea :

 Class constructor

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

 This.area:="myWAOffscreen"

 

 Function onEvent

 Au cas ou

    :(FORM Evenement.code=Sur fin chargement URL)

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

 Fin de cas

Variables et ensembles système

La variable système OK est définie sur 0 si le timeout a été atteint ou si la commande NE PAS VALIDER a été appelée dans onEvent, sinon elle est définie sur 1.

Voir aussi

FORM Evenement
Gestion programmée des zones Web
WA OUVRIR INSPECTEUR WEB