4D Doc Center : PV EXPORTER

4D View v14

PV EXPORTER


PV EXPORTER ( zone ; nomFichier ; remplacer ; format )

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

Description

La commande PV EXPORTER exporte la zone 4D View ou la plage d'export sous forme de document sur disque.

Passez dans nomFichier le nom et le chemin d’accès complet du document à exporter. Si vous passez une chaîne vide dans ce paramètre, une boîte de dialogue d'export 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 exporté.

Si un document de même nom existe à l'endroit indiqué, PV EXPORTER é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.

Utilisez les constantes du thème PV Format documentpour 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

Note : La constante de format de document pv view ne peut pas être appliquée à cette commande.

A la différence de la commande PV ENREGISTRER DOCUMENT (qui enregistre la totalité d'une zone), la commande PV EXPORT permet de n'enregistrer que la zone d'export du document. La zone d'export peut être définie manuellement par l'utilisateur (commande Fichier/Zone d'export>Définir), ou par programmation à l'aide de l'instruction PV EXECUTER COMMANDE(zone;pv cmd export définir zone). La zone d'export est constituée des cellules sélectionnées au moment de la définition de la zone. Par défaut, la zone d'export est constituée de la totalité du document.

Exemple

L'exemple suivant permet d'exporter au format HTML l'ensemble des cellules sélectionnées dans une zone. Si aucune cellule n'est sélectionnée au moment de l'export, une plage arbitraire est définie :

 TABLEAU ENTIER LONG($TabGauche;0) `Numéros de colonne des cellules de gauche

 TABLEAU ENTIER LONG($TabHaut;0) `Numéros de ligne des cellules du haut

 TABLEAU ENTIER LONG($TabDroit;0) `Numéros de colonne des cellules de droite

 TABLEAU ENTIER LONG($TabBas;0) `Numéros de ligne des cellules du bas

 

 PV LIRE LISTE PLAGES SELECT(Zone;$TabGauche;$TabHaut;$TabDroit;$TabBas)

 

 Si(Taille tableau($TabGauche)=0) `Aucune cellule n'est sélectionnée

    PV SELECTIONNER PLAGE(Zone;2;4;5;7;pv sélection définir) `Plage arbitraire

 Sinon

    PV SELECTIONNER LISTE PLAGES(Zone;$TabGauche;$TabHaut;$TabDroit;$TabBas;pv sélection définir)

 Fin de si

 

  `Réduisons la zone d'export à la plage

 PV EXECUTER COMMANDE(Zone;pv cmd export définir zone)

 PV EXPORTER(Zone;"";1;pv html)

 

  `Initialisons la zone d'export à tout le document

 PV EXECUTER COMMANDE(Zone;pv cmd export effacer zone)