version 1
ch_ZONE VERS CHAMP (zone; cible; table; champ; modeEnrg)
| Paramètre | Type | Description | |
| zone | Entier long | Zone 4D Chart | |
| cible | Entier long | Cible de la commande (-2 = Document, -1 = Tout, | |
| 0 = Objets sélectionnés, >0 = Identifiant d'objet) | |||
| table | Entier | Numéro de table | |
| champ | Entier | Numéro de champ | |
| modeEnrg | Entier | Mode de sauvegarde du contenu de zone | |
| (1 = Image seulement, 2 = Données seulement, | |||
| 3 = Image et données, -1 = Pas de changement) |
Description
La commande ch_ZONE VERS CHAMP copie le contenu de zone dans le champ BLOB ou Image spécifié par table et champ.
Cette commande est utile pour stocker des objets dans un champ d'une table associée ou pour ne stocker que des objets spécifiques. Elle affecte simplement les objets de champ. L'enregistrement dans table doit néanmoins être sauvegardé.
Le paramètre cible détermine ce qui est copié.
Le paramètre optionnel modeEnrg fixe le mode de sauvegarde du document dans la zone 4D Chart :
Si modeEnrg est égal à 1, seule l'image (PICT) est sauvegardée. Les objets ne peuvent plus être manipulés individuellement.
Si modeEnrg est égal à 2, seules les données concernant les objets contenus dans la zone 4D Chart sont sauvegardées. L'image est reconstruite ultérieurement en utilisant le contenu des données sauvegardées. Cette option de sauvegarde est la plus rapide et la plus économe en mémoire. S'il n'y a pas suffisamment de mémoire pour la méthode de sauvegarde choisie, un dialogue apparaît pour que vous puissiez choisir une autre méthode.
Si modeEnrg est égal à 3, l'image et les données internes ayant servi à reconstruire l'image sont sauvegardées. C'est la façon normale de sauvegarder un document.
Exemple
L'exemple suivant crée un enregistrement associé pour un objet contenu dans zone.
CREER ENREGISTREMENT([Objets]) `Créer un enregistrement pour stocker l'objet [Objets]Nom:=[Mesgraphes]Nom `Affecter la valeur relative $Temp:=ch_Lire ID(Zone;-1;3) `Obtenir l'identifiant de l'objet ch_ZONE VERS CHAMP(Zone;$Temp;3;2;1) `Copier l'objet dans l'enregistrement STOCKER ENREGISTREMENT([Objets]) `Sauvegarder l'enregistrement
Référence