4D v16.3FORM LOAD |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v16.3
FORM LOAD
FORM LOAD
La commande FORM LOAD vous permet de charger le formulaire (projet ou table) en mémoire dans le process courant afin d'imprimer des données ou d'analyser son contenu. Il ne peut y avoir qu'un seul formulaire courant par process. Pour que cette commande puisse être exécutée, une tâche d'impression doit avoir été ouverte au préalable à l'aide de la commande OPEN PRINTING JOB. La commande OPEN PRINTING JOB effectue un appel implicite à la commande FORM UNLOAD, il est donc nécessaire d’exécuter FORM LOAD dans ce contexte. Une fois chargé, le formulaire devient le formulaire d’impression courant. Toutes les commandes de gestion des objets, et en particulier la commande Print object, travaillent avec ce formulaire. Si un formulaire d’impression avait déjà été chargé au préalable (via un appel précédent à la commande FORM LOAD), il est refermé et remplacé par formulaire. Vous pouvez ouvrir et refermer plusieurs formulaires dans la même session d’impression. Changer de formulaire d’impression via la commande FORM LOAD ne génère pas de saut de page, il revient au développeur de les gérer. Seul l’événement formulaire On Load est exécuté durant l’ouverture du formulaire, ainsi que les méthodes des objets du formulaire. Les autres événements formulaire sont ignorés. L’événement formulaire On Unload est exécuté à l’issue de l’impression. Pour préserver la cohérence graphique des formulaires, il est conseillé d’appliquer la propriété d’apparence "Impression" sur toutes les plates-formes. Le formulaire d’impression courant est automatiquement refermé lorsque la commande CLOSE PRINTING JOB est appelée. Note de compatibilité : Dans les versions de 4D antérieures à la v14, la commande FORM LOAD (nommée OUVRIR FORMULAIRE IMPRESSION) acceptait une chaîne vide dans le paramètre formulaire afin de refermer le formulaire projet courant. Cette syntaxe n’est désormais plus prise en charge et retourne une erreur. Vous devez désormais utiliser la commande FORM UNLOAD ou la commande CLOSE PRINTING JOB pour refermer le formulaire. Cette possibilité consiste à charger un formulaire hors-écran à des fins d’analyse. Pour effectuer cette action, il suffit d’appeler FORM LOAD en-dehors d’un contexte de tâche d’impression. Dans ce cas, les événements formulaire ne sont pas exécutés. FORM LOAD peut être utilisé avec les commandes FORM GET OBJECTS et OBJECT Get type afin d’effectuer tout type de traitement sur le contenu du formulaire. Il est ensuite impératif d'appeler la commande FORM UNLOAD afin de décharger le formulaire de la mémoire. A noter que dans tous les cas, le formulaire à l’écran reste chargé (il n’est pas touché par la commande FORM LOAD), il n’est pas nécessaire de le recharger après un FORM UNLOAD. Si la commande est exécutée depuis un composant, elle charge par défaut les formulaires du composant. Si vous passez le paramètre *, la méthode chargera les formulaires de la base hôte. Rappel : Dans le contexte du hors-écran, n'oubliez pas d'appeler FORM UNLOAD afin d'éviter tout risque de saturation de la mémoire. Appel d’un formulaire projet en tâche d’impression : OPEN PRINTING JOB Appel d’un formulaire table en tâche d’impression : OPEN PRINTING JOB Analyse du contenu d’un formulaire pour effectuer un traitement sur les zones de saisie de texte : FORM LOAD([People];"my_form")
Voir aussi
|
PROPRIÉTÉS
Produit : 4D
HISTORIQUE
Créé : 4D v12 UTILISATION DE L'ARTICLE
4D - Langage ( 4D v16) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||