PV EXPORT

4D View v16

PV EXPORT


PV EXPORT ( 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 :

 ARRAY LONGINT($TabGauche;0) `Numéros de colonne des cellules de gauche

 ARRAY LONGINT($TabHaut;0) `Numéros de ligne des cellules du haut

 ARRAY LONGINT($TabDroit;0) `Numéros de colonne des cellules de droite

 ARRAY LONGINT($TabBas;0) `Numéros de ligne des cellules du bas

 

 PV GET SELECTED RANGES LIST(Zone;$TabGauche;$TabHaut;$TabDroit;$TabBas)

 

 If(Size of array($TabGauche)=0) `Aucune cellule n'est sélectionnée

    PV SELECT RANGE(Zone;2;4;5;7;pv selection set) `Plage arbitraire

 Else

    PV SELECT RANGES LIST(Zone;$TabGauche;$TabHaut;$TabDroit;$TabBas;pv selection set)

 End if

 

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

 PV EXECUTE COMMAND(Zone;pv cmd export area set)

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

 

  `Initialisons la zone d'export à tout le document

 PV EXECUTE COMMAND(Zone;pv cmd export area clear)

Voir aussi

PV SAVE DOCUMENT