VP Run offscreen area

4D v19


VP Run offscreen area ( parameters ) -> Résultat

Paramètre	Type	Description
parameters	Objet	Objet contenant les attributs de la zone hors écran
Résultat	Varié	Propriété .result de l'objet onEvent, ou Null s'il ne retourne pas de valeur.

Description

La commande VP Run offscreen area crée, dans la mémoire, une zone hors écran qui peut être utilisée pour traiter les commandes et fonctions d'une zone 4D View Pro.

Dans l'objet parameters, passez l'une des propriétés optionnelles suivantes. Ces propriétés seront disponibles grâce à la commande This dans la méthode onEvent et référencent l'instance :

Propriété	Type	Description
area	texte	Le nom de la zone hors écran. S'il est omis ou null, un nom générique est assigné (ex : OffscreenArea1).
onEvent	objet (formula)	Une méthode callback qui sera lancée lorsque la zone hors écran sera prête. Elle peut être soit : une fonction onEvent d'une classe, soit un objet Formule Par défaut, la méthode callback est appelée sur les événements Sur VP prêt, Sur chargement, Sur libération, Sur fin chargement URL, Sur erreur chargement URL, Sur VP Plage changée, ou Sur minuteur La méthode callback peut être utilisée pour accéder à l'objet 4D View Pro. Voir Variable de l'objet formulaire 4D View Pro .
autoQuit	booléen	Vrai (valeur par défaut) si la commande doit stopper l'exécution de la formule lorsque les événements 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 onEvent.
timeout	réel	Durée maximale (exprimée en secondes) avant la fermeture de la zone si aucun événement n'est généré. Si elle est fixée à 0, aucune limitation n'est appliquée. Valeur par défaut : 60
result	mixte	Résultat du traitement (le cas échéant).
<customProperty>	mixte	Tout attribut personnalisé qui sera disponible dans la méthode callback onEvent.

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

Propriété	Type	Description
timeoutReached	booléen	Ajouté avec la valeur vrai si le timeout a été dépassé

Note : La zone hors écran est uniquement disponible durant l'exécution de la commande VP Run offscreen area. Elle sera automatiquement détruite à la fin de l'exécution.

Les commandes suivantes peuvent être utilisées dans la méthode callback (de rétro-appel) :

Exemple 1

Vous souhaitez créer une zone 4D View Pro hors écran et lire la valeur d'une cellule :

  // Déclaration de la classe OffscreenArea

 Class constructor 

 C_TEXTE($1)&nbsp;

 This.filePath:=$1

 

  //  Cette fonction sera appelée sur chaque événement de la zone hors écran

 Fonction onEvent

 Au cas ou:(FORM Evenement.code=Sur VP prêt)

       VP IMPORT DOCUMENT(This.area;This.filePath)

       This.result:=VP Get value(VP Cell(This.area;6;22)) 

 

       ALERTE("La cellule G23 contient la valeur : "+Chaine(This.result)) 

 Fin de cas

La méthode callback (de rétro-appel) OffscreenArea :

 $o:=cs.OffscreenArea.new() 

 

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

Exemple 2

Vous souhaitez charger un grand document hors écran, attendre que tous les calculs soient terminés et l'exporter au format PDF:

  //Déclaration de la classe OffscreenArea

 class constructor($pdfPath Text)

 This.pdfPath:=$pdfPath

 This.autoQuit:=False

 This.isWaiting:=False

 

 Function onEvent

 Au cas ou

    :(FORM Evenement.code=On VP Ready)

  // Import du document

       VP IMPORT DOCUMENT(This.area;$largeDocument4VP)

       This.isWaiting:=True 

 

  // Démarrer un minuteur pour vérifier si tous les calculs sont terminés.

  // Si pendant cette période le "On VP Range Changed" est lancé, le minuteur sera redémarré

  // L'heure doit être définie en fonction de la configuration de l'ordinateur.</p> <p>FIXER MINUTEUR(60)

 

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

  //Fin du calcul détectée. Redémarre le minuteur

       Si(This.isWaiting)

          FIXER MINUTEUR(60)

       Fin de si

 

    :(FORM Evenement.code=On Timer)

  // Pour être sûr de ne pas redémarrer le minuteur si vous appelez d'autres commandes 4D View après ce point

       This.isWaiting:=False

 

  // Stopper le minuteur

       FIXER MINUTEUR(0)

 

  // Démarrer l'export PDF

       VP EXPORT DOCUMENT(This.area;This.pdfPath;Creer objet("formula";Formule(ACCEPT)))

 

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

       ANNULER

 Fin de cas

La méthode callback OffscreenArea :

 $o:=cs.OffscreenArea.new()

 

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

Voir aussi

Blog post: End of document loading