4D Doc Center : PV ENREGISTRER DOCUMENT

4D View v14

PV ENREGISTRER DOCUMENT


PV ENREGISTRER DOCUMENT ( zone ; nomFichier ; modèle ; remplacer ; format )

Paramètre	Type	Description
zone	Entier long	Zone 4D View
nomFichier	Chaîne	Nom du document ou chaîne vide
modèle	Entier	0 = Document ; 1 = Modèle
remplacer	Entier	0 = Pas de remplacement ; 1 = Remplacement
format	Entier long	Format du document

Description

La commande PV ENREGISTRER DOCUMENT sauvegarde la zone 4D View sous forme de document sur disque.

Passez dans nomFichier le nom et le chemin d’accès complet du document à enregistrer. Si vous passez une chaîne vide dans ce paramètre, une boîte de dialogue standard d'enregistrement de fichiers apparaîtra et l'utilisateur pourra spécifier le nom et l'emplacement du document. Si dans ce cas l'utilisateur clique sur le bouton Annuler, le document n'est pas enregistré.

Le paramètre modèle vous permet de définir si vous souhaitez que le document soit enregistré en tant que document standard (modèle = 0) ou en tant que modèle (modèle = 1). Pour plus d’informations sur la notion de modèle, reportez-vous à la description de la commande PV OUVRIR DOCUMENT.

Si un document de même nom existe à l'endroit indiqué, PV ENREGISTRER DOCUMENT écrase ou non ce dernier en fonction de la valeur du paramètre remplacer. Dans ce cas, lorsque remplacer est à 0, une erreur n°26 survient : "Ce document existe déjà". Si le nom a été défini par l'utilisateur (chaîne vide dans nomFichier), c'est le système d'exploitation qui affiche la traditionnelle confirmation "Ce document existe déjà..." quelle que soit la valeur de remplacer.

Si le document à remplacer est déjà utilisé par une autre zone 4D View, PV ENREGISTRER DOCUMENT retourne une erreur, qu’il s’agisse ou non d’un modèle.

Utilisez les constantes du thème PV Format document pour définir le paramètre format, permettant de spécifier le format d'enregistrement du document :

Constante	Type	Valeur
pv html	Entier long	3
pv sylk	Entier long	2
pv tab tab return	Entier long	1
pv view	Entier long	0

Exemple

Après ouverture d’un document externe avec la commande PV OUVRIR DOCUMENT, nous installons tout d'abord une méthode de rétro-appel détectant le changement de cellule active :

 C_BOOLEEN(FlagZoneModifiée)

 PV APPELER SUR EVENEMENT(Zone;pv sur nouvelle cellule active;"MéthodeEvénement")

Le code de la méthode projet MéthodeEvénement est le suivant :

 C_ENTIER LONG($1)&nbsp;&nbsp; `Référence de la zone 4D View

 C_ENTIER LONG($2)&nbsp;&nbsp; `Type d'événement

 C_ENTIER LONG($3)&nbsp;&nbsp; `Code de la touche de modification

 C_ENTIER LONG($4)&nbsp;&nbsp; `Numéro de la colonne<gen9>C_ENTIER LONG($5)  `Numéro de la ligne

 C_ENTIER LONG($6)&nbsp;&nbsp; `Code ASCII de la touche

 C_BOOLEEN($0)&nbsp;&nbsp; `Retour de la fonction

 

 $0:=Faux

 

 FlagZoneModifiée:=Vrai   `Zone modifiée</gen9>

Si le document a été modifié, nous proposons ensuite à l'utilisateur d'enregistrer sous le nom de son choix le document résultant des modifications :

 Si(FlagZoneModifiée)   `Document modifié ?

    CONFIRMER("Voulez-vous enregistrer ce document en tant que modèle ?";"Modèle";"Document")

  `Ce sera un modèle si le dialogue a été confirmé (OK=1)

    PV ENREGISTRER DOCUMENT(Zone;"";OK;1;pv view)

 Fin de si

Variables et ensembles système

La variable système OK prend la valeur 1 si le document a été correctement enregistré.