<Variable zipArchive>.Regroupe (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des archives

Conditions d'utilisation
Codes d'erreur
Fermeture de l'archive
Nombre de parties
Actions réalisables sur une archive multi-parties
L'archive multi-parties est présente sur des disquettes

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

<Variable zipArchive>.Regroupe (Fonction)

En anglais : <zipArchive variable>.Merge

Regroupe les différentes sous-archives d'une archive multi-parties pour en faire une archive mono-partie.

Exemple

MonArchive est une zipArchive
// Ouverture d'une archive multi-parties
ResOuvreArchive = MonArchive.Ouvre("C:\MesArchives\Archive.zip") 
SI ResOuvreArchive = 0 ALORS
	...
	// Regroupement des sous-archives d'une archive multi-parties
	ResRegroupe = MonArchive.Regroupe(...
			 "C:\MesArchives\ArchiveMono.WDZ")
	...
FIN

Syntaxe

<Résultat> = <Archive>.Regroupe(<Destination de l'archive> [, <Gestion de la jauge>])

<Résultat> : Entier

0 si les sous-archives ont été regroupées,
un code d'erreur (valeur supérieure à 0) dans le cas contraire. Pour plus de détails sur ces codes d'erreur, consultez les Remarques.

<Archive> : Variable de type zipArchive

Nom d'une variable de type zipArchive correspondant à l'archive à manipuler.

<Destination de l'archive> : Chaîne de caractères

Chemin physique de la nouvelle archive mono-partie (260 caractères maximum). Ce chemin doit contenir le nom de l'archive mono-partie à créer. Si l'extension (.WDZ ou .ZIP) n'est pas précisée, l'extension correspond à l'extension originale. Il est possible de spécifier le même chemin et nom que l'archive découpée : l'archive découpée sera écrasée par l'archive regroupée.

<Gestion de la jauge> : Chaîne de caractères optionnelle

Nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression du regroupement.

Remarques

Conditions d'utilisation

Remarque : Le regroupement ne peut être réalisé que si :

L'archive existe (la création d'une archive s'effectue avec la fonction <Variable zipArchive>.Crée).
L'archive est multi-parties.
L'archive n'est pas au format "CAB", au format "RAR" ou au format "gzip", "TAR" ou TARGZ".

Rappel :

Seules les archives au format ZIP, gzip, TAR et TGZ (TAR.GZ) sont disponibles.
Seules les archives au format ZIP sont disponibles.

Codes d'erreur

Les codes d'erreur retournés sont les suivants :

1 : Le chemin passé en paramètre n'existe pas.
2 : Accès interdit : l'utilisateur n'a pas les droits nécessaires.
3 : L'archive est corrompue.
6 : Les sous-archives ne sont pas dans l'ordre.

Le message correspondant au code d'erreur peut être connu grâce à la fonction zipMsgErreur.

Fermeture de l'archive

Après utilisation de la fonction <Variable zipArchive>.Regroupe sur une archive, cette archive ne se ferme pas. Il est nécessaire d'utiliser les fonctions :

<Variable zipArchive>.Ferme pour fermer l'archive multi-parties.
<Variable zipArchive>.Ouvre pour ouvrir la nouvelle archive mono-partie.

Nombre de parties

La fonction zipNbPartie permet de connaître le nombre de sous-archives d'une archive multi-parties.

Actions réalisables sur une archive multi-parties

Certaines fonctions d'archivage sont utilisables uniquement sur des archives mono-partie (ajout et suppression de fichiers, création d'un exécutable auto-extractible, etc.). Pour effectuer ces opérations, il suffit de regrouper les sous-archives (<Variable zipArchive>.Regroupe) pour obtenir une archive mono-partie.

A partir d'une archive multi-parties, il est uniquement possible de :

Regrouper les différentes parties (fonction <Variable zipArchive>.Regroupe).
Obtenir diverses informations sur l'archive et sur les fichiers de l'archive (fonctions <Variable zipArchive>.ExtraitChemin, <Variable zipArchive>.InfoFichier, <Variable zipArchive>.ListeFichier, etc.).
Extraire les fichiers (fonctions <Variable zipArchive>.ExtraitFichier, <Variable zipArchive>.ExtraitTout).

L'archive multi-parties est présente sur des disquettes

Si les différentes sous-archives sont présentes sur disquettes, la disquette suivante sera automatiquement demandée lors du regroupement par l'intermédiaire d'une boîte de dialogue. Si l'utilisateur annule le regroupement, une erreur sera générée (l'archive multi-parties est introuvable).

Composante : wd300zip.dll

Voir Aussi

Version minimum requise

Version 24

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 19/06/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale