version 6.0
Un document 4D Draw peut exister dans trois contextes différents :
dans un formulaire 4e Dimension,
dans une fenêtre externe,
dans une zone invisible, nommée hors écran.
Variable zone
Dans les descriptions de commandes et fonctions de ce manuel, le terme zone correspond au numéro d'identification de la zone désignée. Cette variable est de type Entier long. L'entier long est une adresse mémoire qui permet à 4e Dimension de localiser la feuille de dessin. Comme zone est un entier long, elle peut être utilisée comme paramètre dans les méthode projets de 4e Dimension.
La variable zone peut être :
Le nom de l'objet externe, utilisé par 4e Dimension comme variable pour désigner une feuille de dessin incluse dans un formulaire.
Une variable que vous créez pour désigner une feuille de dessin dans une fenêtre externe ou une zone hors écran.
Référence d'une zone 4D Draw dans un formulaire
Lorsque vous créez un objet externe dans un formulaire, 4D utilise son nom comme variable. Il charge automatiquement la variable en mémoire à chaque ouverture du formulaire. Cette variable contient l'adresse mémoire où se trouvent la feuille de dessin et ses objets. Comme 4e Dimension peut attribuer à cette variable n'importe quelle adresse mémoire disponible, l'ID de l'objet externe peut changer à chaque ouverture du formulaire.
Par conséquent, pour désigner une feuille de dessin en formulaire inclus, vous devrez appeler le paramètre zone du nom de l'objet externe. L'ID est automatiquement assigné par 4D.
Lorsque vous voulez désigner une feuille de dessin en formulaire inclus, utilisez le nom que vous avez choisi pour la zone lors de sa création. Le formulaire doit être ouvert.
Référence d'une zone hors écran 4D Draw
Vous pouvez créer une zone logique pour vos dessins, invisible pour l'utilisateur, à l'aide de la fonction dr_Hors ecran. Cette fonction est décrite dans le thème "DR Gestion des documents".
Cette fonction, qui vous permet de créer une zone hors écran, renvoie un numéro d'ID. Passez ce résultat dans une variable, qui contiendra alors l'ID de la zone hors écran.
Par exemple, l'instruction suivante crée une zone hors écran et stocke son ID dans la variable vZone :
vZone:=dr_Hors ecran
Vous pouvez ensuite utiliser la commande dr_CHAMP VERS ZONE pour charger un champ image 4D (contenant une zone 4D Draw) dans la zone hors écran.
N'oubliez pas de supprimer vos zones hors écran une fois que vous n'en avez plus besoin afin de libérer la mémoire qu'elles occupent. Si vous quittez l'application sans avoir refermé toutes les zones hors écran, un message d'alerte vous le signale.
Référence d'une fenêtre externe 4D Draw
Pour ouvrir une fenêtre externe et y inclure une feuille de dessin 4D Draw, utilisez la fonction de 4e Dimension Creer fenetre externe.
Les fonctions qui vous permettent de créer une fenêtre externe vous renvoient un numéro d'ID. Passez ce résultat dans une variable, qui contiendra alors l'ID de la fenêtre externe.
Par exemple, l'instruction suivante crée une fenêtre externe et stocke son ID dans la variable vDraw :
vDraw:=Creer fenetre externe (50; 20; 250; 250; 721; "Schéma"; "_4D Draw")
Ensuite, vous pouvez utiliser cette variable pour désigner la feuille de dessin :
RefModDes:=dr_Lire mode dessin(vDraw)
Pour plus d'informations sur la fonction Creer fenetre externe, reportez-vous au manuel Langage de 4D.