Utiliser les zones 4D View

Vous pouvez travailler par programmation avec 4D View dans les environnements suivants :

• Zones 4D View incluses dans des formulaires
• Fenêtres externes 4D View
• Zones 4D View hors écran

Pour travailler dans un document 4D View, vous devrez soit créer une zone de plug-in dans un formulaire, soit ouvrir une fenêtre externe.

Pour créer une zone de plug-in dans un formulaire, dessinez-la dans l'éditeur de formulaires de 4D, en mode Développement.

Pour ouvrir une fenêtre externe, choisissez la commande 4D View dans le menu Outils de 4D ou exécutez la commande 4D Creer fenetre externe.

Outre les zones visibles, 4D View permet de créer des zones hors écran, donc invisibles. Pour plus d'informations sur ces zones, reportez-vous au paragraphe “Zones hors écran de 4D View”, plus loin dans cette section.

Lors de la manipulation d’un document 4D View à l’aide des routines, il est nécessaire de spécifier son identifiant de zone. Cet identifiant est interne à 4D View et se trouve généralement dans une variable.

4D View utilise des variables pour stocker l’emplacement des zones incluses, des fenêtres externes et des zones hors écran. Pour référencer la zone sur laquelle vous désirez effectuer une opération, passez la variable contenant l’identifiant de zone comme paramètre à la commande ou à la fonction.

Dans les descriptions de commandes de cette documentation, la variable de type Entier long identifiant la zone de document de 4D View est appelée zone.

Il existe deux types de variables zone :

• Les noms de zones incluses
• Les variables créées pour une fenêtre externe ou une zone hors écran

Lorsque vous créez et nommez une zone 4D View dans un formulaire, 4D considère que le nom de la zone 4D View est la variable faisant référence à la zone. Par exemple, vous vous référeriez à la zone “Feuille” en spécifiant “Feuille” comme paramètre zone.

Lorsque vous créez une fenêtre externe ou une zone hors écran à l’aide des fonctions Creer fenetre externe ou PV Creer zone hors ecran, le numéro d’identification de zone renvoyé par la fonction doit être stocké dans une variable. Vous pourrez par la suite utiliser cette variable pour faire référence à la fenêtre externe ou à la zone hors écran dans d’autres commandes et fonctions. Pour stocker la valeur dans une variable, placez le nom de la variable et l’opérateur d’affectation (:=) à gauche de la fonction dans la ligne de code.

L’exemple suivant crée une fenêtre externe 4D View et stocke le numéro d’identifiant de zone dans la variable MaZone :

Une zone 4D View peut être placée dans tout formulaire : le plus souvent, dans un formulaire entrée pour pouvoir travailler avec des documents, mais également dans un formulaire sortie, pour afficher ou imprimer des informations.

4D View utilisera tout le formulaire ou partagera l’espace avec des champs et d’autres éléments du formulaire.

Vous devez utiliser une zone d’objet actif du type “Zone de plug-in” pour 4D View. Une zone de plug-in est l’un des multiples types d’objets actifs dans 4D (les boutons, les zones saisissables, les zones de défilement, etc. en sont également).

Vous pouvez associer la zone de plug-in à un champ 4D, de manière à ce que le contenu de la zone soit sauvegardé avec chaque enregistrement. Attention, si vous n'utilisez pas les boutons automatiques du type Valider mais la commande STOCKER ENREGISTREMENT, il vous faudra au préalable exécuter PV Zone vers blob pour transférer le contenu de la zone 4D View dans le champ 4D, car dans ce cas le mécanisme de sauvegarde automatique n'est pas activé.

Pour plus d’informations sur la création de zones 4D View dans des formulaires, reportez-vous au manuel d'utilisation de 4D View.

Utilisez la fonction Creer fenetre externe de 4D pour ouvrir une fenêtre externe et y afficher un document 4D View vierge.

Creer fenetre externe ouvre une nouvelle fenêtre, affiche le plug-in spécifié et retourne un numéro d’identifiant pour la zone.

Voici un exemple d’utilisation de Creer fenetre externe. Cette instruction ouvre une fenêtre externe et affiche un document 4D View vide.

Par la suite, vous utiliserez RefZonePv chaque fois que vous devrez vous référer à ce document.
Pour une description complète de la commande Creer fenetre externe, reportez-vous au manuel Langage de 4D.

Une zone hors écran est stockée en mémoire : elle est invisible pour le programmeur et l’utilisateur. Elle sera généralement utile dans deux cas : pour modifier un document avant que l’utilisateur ne le visualise ou pour sauvegarder le document afin que l’utilisateur puisse revenir à l’original, si nécessaire.

Les opérations de 4D View fonctionnent plus rapidement dans une zone hors écran, car il n’est pas nécessaire de redessiner la zone.

Utilisez la fonction PV Creer zone hors ecran pour créer une zone hors écran.

N’oubliez pas de supprimer la zone hors écran après utilisation pour libérer la mémoire qu’elle occupe, à l’aide de la routine PV SUPPRIMER ZONE HORS ECRAN. Si vous fermez la base de données sans avoir détruit toutes les zones hors écran, 4D affichera un message d’erreur.