PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Condition d'utilisation
  • Niveau de compression
  • Codes d'erreur
  • Ajout d'un fichier déjà présent dans l'archive
  • Indice des fichiers dans l'archive
  • Jauge
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Ajoute et compresse automatiquement une liste de fichiers (de n'importe quel type) dans une archive au format ZIP, CAB, WDZ, 7z, TAR ou TGZ (TAR.GZ). Cette fonction est plus rapide que la fonction zipAjouteFichier exécutée pour chaque fichier.
Versions 15 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
Nouveauté 15
Android Cette fonction est désormais disponible pour les applications Android.
Android Cette fonction est désormais disponible pour les applications Android.
Versions 17 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
Widget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEVWEBDEV - Code ServeurWindows Cette fonction gère désormais le format 7z.
Nouveauté 18
Widget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEVWEBDEV - Code ServeurWindows Cette fonction gère désormais le format 7z.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEVWEBDEV - Code ServeurWindows Cette fonction gère désormais le format 7z.
Versions 19 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 19
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Versions 21 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
WINDEVWEBDEV - Code ServeurWindowsLinuxiPhone/iPadUniversal Windows 10 App Cette fonction gère désormais les formats TAR et TGZ (TAR.GZ).
Nouveauté 21
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
WINDEVWEBDEV - Code ServeurWindowsLinuxiPhone/iPadUniversal Windows 10 App Cette fonction gère désormais les formats TAR et TGZ (TAR.GZ).
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
WINDEVWEBDEV - Code ServeurWindowsLinuxiPhone/iPadUniversal Windows 10 App Cette fonction gère désormais les formats TAR et TGZ (TAR.GZ).
Exemple
WINDEVWEBDEV - Code ServeurEtats et RequêtesAjaxCode Utilisateur (MCU)
// Création d'une archive et ajout d'un élément
// Avec jauge
NumEvénement est un entier
NumErrZip est un entier
 
NumErrZip = zipCrée("MonArchive", "C:\Doc\Archive\ficArchive.zip")
SI NumErrZip = 0 ALORS
NumEvénement = Evénement("Aff_Jauge_Compression", FenEnExécution(), JaugeCompactage)
NumErrZip = zipAjouteListeFichier("MonArchive", "C:\doc\Image\Maison.BMP" + RC + ...
"C:\Mes Projets\WDStock\WDStock.wdp")
SI NumErrZip <> 0 ALORS
Erreur(zipMsgErreur(NumErrZip))
FIN
FinEvénement(NumEvénement)
zipFerme("MonArchive")
SINON
Erreur(zipMsgErreur(NumErrZip))
FIN
 
// Procédure à appeler pour gérer la jauge
PROCÉDURE Aff_Jauge_Compression
Jauge(_EVE.wParam, 100)
WINDEVWEBDEV - Code ServeurEtats et RequêtesAjaxCode Utilisateur (MCU)
// Création d'une archive et ajout d'un élément
// Avec jauge affichée dans un champ Jauge
MonArchive est un zipArchive
NumErrZip est un entier
 
NumErrZip = zipCrée(MonArchive, "C:\Doc\Archive\ficArchive.zip")
SI NumErrZip = 0 ALORS
NumErrZip = zipAjouteListeFichier(MonArchive, "C:\doc\Image\Maison.BMP" + RC + ...
"C:\Mes Projets\WDStock\WDStock.wdp", zipDisque, JAUGE_Progression)
SI NumErrZip <> 0 ALORS
Erreur(zipMsgErreur(NumErrZip))
FIN
zipFerme(MonArchive)
SINON
Erreur(zipMsgErreur(NumErrZip))
FIN
 
Windows Mobile
// Création d'une archive et ajout d'un élément
// Avec jauge
NumEvénement est un entier
NumErrZip est un entier
 
NumErrZip = zipCrée("MonArchive", "\Doc\Archive\ficArchive.zip")
SI NumErrZip = 0 ALORS
NumEvénement = Evénement("Aff_Jauge_Compression", FenEnExécution(), JaugeCompactage)
NumErrZip = zipAjouteListeFichier("MonArchive", "\doc\Image\Maison.BMP" + RC + ...
"\Mes Projets\WDStock\WDStock.wdp")
SI NumErrZip <> 0 ALORS
Erreur(zipMsgErreur(NumErrZip))
FIN
FinEvénement(NumEvénement)
zipFerme("MonArchive")
SINON
Erreur(zipMsgErreur(NumErrZip))
FIN
 
// Procédure à appeler pour gérer la jauge
PROCÉDURE Aff_Jauge_Compression
Jauge(_EVE.wParam, 100)
Windows Mobile
// Création d'une archive et ajout d'un élément
// Avec jauge affichée dans un champ Jauge
MonArchive est un zipArchive
NumErrZip est un entier
 
NumErrZip = zipCrée(MonArchive, "\Doc\Archive\ficArchive.zip")
SI NumErrZip = 0 ALORS
NumErrZip = zipAjouteListeFichier(MonArchive, "\doc\Image\Maison.BMP" + RC + ...
"\Mes Projets\WDStock\WDStock.wdp", zipRépertoire, JAUGE_Progression)
SI NumErrZip <> 0 ALORS
Erreur(zipMsgErreur(NumErrZip))
FIN
zipFerme(MonArchive)
SINON
Erreur(zipMsgErreur(NumErrZip))
FIN
 
Syntaxe

Ajouter une liste de fichiers (fichiers séparés par RC) Masquer les détails

<Résultat> = zipAjouteListeFichier(<Archive> , <Chemin des fichiers à ajouter> [, <Portion du chemin à mémoriser> [, <Gestion de la jauge>]])
<Résultat> : Entier
  • 0 si l'ajout a été effectué,
  • 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> : Chaîne de caractères (avec guillemets) ou variable de type zipArchive
Nom de l'archive dans laquelle les fichiers doivent être ajoutés.
Ce nom peut correspondre :
  • soit au nom d'une archive défini avec la fonction zipOuvre ou zipCrée.
  • Versions 15 et supérieures
    WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobileAjax soit au nom d'une variable de type zipArchive.
    Nouveauté 15
    WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobileAjax soit au nom d'une variable de type zipArchive.
    WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobileAjax soit au nom d'une variable de type zipArchive.
<Chemin des fichiers à ajouter> : Chaîne de caractères (avec guillemets)
Nom et chemin des fichiers à ajouer dans l'archive, séparés par des RC. Ces chemins peuvent être complets ou relatifs au répertoire en cours. La taille de chaque chemin ne doit pas dépasser 260 caractères maximum.
La taille de chaque fichier doit être inférieure à 4 Go. Dans le cas contraire, une erreur est générée.
Il n'est pas possible d'utiliser des caractères jokers.
Versions 18 et supérieures
WINDEVEtats et RequêtesWindows MobileCode Utilisateur (MCU) Ce paramètre est de la forme :
<Chemin du fichier> [ + TAB + <Chemin à mémoriser> ] + RC
Si un chemin à mémoriser est précisé, l'ajout sera équivalent à un ajout du fichier suivi d'un appel à la fonction zipChangeChemin.
Nouveauté 18
WINDEVEtats et RequêtesWindows MobileCode Utilisateur (MCU) Ce paramètre est de la forme :
<Chemin du fichier> [ + TAB + <Chemin à mémoriser> ] + RC
Si un chemin à mémoriser est précisé, l'ajout sera équivalent à un ajout du fichier suivi d'un appel à la fonction zipChangeChemin.
WINDEVEtats et RequêtesWindows MobileCode Utilisateur (MCU) Ce paramètre est de la forme :
<Chemin du fichier> [ + TAB + <Chemin à mémoriser> ] + RC
Si un chemin à mémoriser est précisé, l'ajout sera équivalent à un ajout du fichier suivi d'un appel à la fonction zipChangeChemin.
Windows Mobile Nom et chemin complet des fichiers à ajouter dans l'archive, séparés par des RC. La taille de chaque chemin ne doit pas dépasser 260 caractères.
Universal Windows 10 App Le chemin d'accès au fichier est un chemin complet ou relatif au répertoire de travail de l'application (connu avec la fonction fRepDonnées). Seuls les fichiers présents dans le répertoire de travail peuvent être ajoutés à l'archive.
<Portion du chemin à mémoriser> : Constante optionnelle
Versions 18 et supérieures
WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobileAjaxCode Utilisateur (MCU) Indique la portion de chemin des fichiers présents dans la liste à mémoriser dans l'archive. Ce paramètre est pris en compte uniquement pour les fichiers pour lesquels le <Chemin à mémoriser> n'a pas été précisé.
zipAucunMémorise uniquement le nom et l'extension du fichier. Par exemple : NomFichier.pdf
zipRépertoireMémorise les différents répertoires composant le chemin, le nom et l'extension du fichier. Par exemple : \Répertoire\Fichiers\NomFichier.pdf
zipDisque
(Valeur par défaut)
Mémorise le chemin complet et absolu du fichier (nom du disque, des répertoires, du fichier et l'extension du fichier). Par exemple : C:\Répertoire\Fichiers\NomFichier.pdf
Pour le format ZIP : Cette constante n'a pas d'effet.
Pour le format 7z : Cette constante a le même effet que la constante zipRépertoire.
LinuxWindows Mobile Cette constante n'est pas disponible car il n'y a pas de racine de lecteur.
Si vous manipulez une archive au format .CAB, seule la constante zipAucun est prise en compte. En effet, le format .CAB ne permet pas de stocker des chemins à l'intérieur de l'archive.
Universal Windows 10 App Ce paramètre n'est pas disponible : seuls le nom du fichier et son extension sont mémorisés.
Nouveauté 18
WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobileAjaxCode Utilisateur (MCU) Indique la portion de chemin des fichiers présents dans la liste à mémoriser dans l'archive. Ce paramètre est pris en compte uniquement pour les fichiers pour lesquels le <Chemin à mémoriser> n'a pas été précisé.
zipAucunMémorise uniquement le nom et l'extension du fichier. Par exemple : NomFichier.pdf
zipRépertoireMémorise les différents répertoires composant le chemin, le nom et l'extension du fichier. Par exemple : \Répertoire\Fichiers\NomFichier.pdf
zipDisque
(Valeur par défaut)
Mémorise le chemin complet et absolu du fichier (nom du disque, des répertoires, du fichier et l'extension du fichier). Par exemple : C:\Répertoire\Fichiers\NomFichier.pdf
Pour le format ZIP : Cette constante n'a pas d'effet.
Pour le format 7z : Cette constante a le même effet que la constante zipRépertoire.
LinuxWindows Mobile Cette constante n'est pas disponible car il n'y a pas de racine de lecteur.
Si vous manipulez une archive au format .CAB, seule la constante zipAucun est prise en compte. En effet, le format .CAB ne permet pas de stocker des chemins à l'intérieur de l'archive.
Universal Windows 10 App Ce paramètre n'est pas disponible : seuls le nom du fichier et son extension sont mémorisés.
WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobileAjaxCode Utilisateur (MCU) Indique la portion de chemin des fichiers présents dans la liste à mémoriser dans l'archive. Ce paramètre est pris en compte uniquement pour les fichiers pour lesquels le <Chemin à mémoriser> n'a pas été précisé.
zipAucunMémorise uniquement le nom et l'extension du fichier. Par exemple : NomFichier.pdf
zipRépertoireMémorise les différents répertoires composant le chemin, le nom et l'extension du fichier. Par exemple : \Répertoire\Fichiers\NomFichier.pdf
zipDisque
(Valeur par défaut)
Mémorise le chemin complet et absolu du fichier (nom du disque, des répertoires, du fichier et l'extension du fichier). Par exemple : C:\Répertoire\Fichiers\NomFichier.pdf
Pour le format ZIP : Cette constante n'a pas d'effet.
Pour le format 7z : Cette constante a le même effet que la constante zipRépertoire.
LinuxWindows Mobile Cette constante n'est pas disponible car il n'y a pas de racine de lecteur.
Si vous manipulez une archive au format .CAB, seule la constante zipAucun est prise en compte. En effet, le format .CAB ne permet pas de stocker des chemins à l'intérieur de l'archive.
Universal Windows 10 App Ce paramètre n'est pas disponible : seuls le nom du fichier et son extension sont mémorisés.
<Gestion de la jauge> : Chaîne de caractères optionnelle (avec ou sans guillemets)
Versions 21 et supérieures
Mode de gestion de la jauge. Ce paramètre peut correspondre :
  • WINDEViPhone/iPadWindows MobileUniversal Windows 10 App au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression de la totalité des fichiers manipulés.
  • au nom d'une procédure WLangage. Cette procédure est de la forme :
    PROCEDURE <Nom de la procédure> (<Fichier en cours>,
    <Pourcentage d'avancement global>, <Pourcentage d'avancement du fichier>)

    où :
    • <Fichier en cours> correspond au nom du fichier en cours de traitement.
    • <Pourcentage d'avancement global> correspond au pourcentage d'avancement de l'ajout des fichiers dans l'archive.
    • <Pourcentage d'avancement du fichier> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive :
  • au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout de chaque fichier.
  • au format 7z, seul le paramètre <Pourcentage d'avancement global> est renseigné. Le paramètre <Pourcentage d'avancement du fichier> aura la même valeur.
WEBDEV - Code Serveur La procédure doit être une procédure serveur.
AndroidWidget AndroidJava Ce paramètre n'est pas disponible.
Nouveauté 21
Mode de gestion de la jauge. Ce paramètre peut correspondre :
  • WINDEViPhone/iPadWindows MobileUniversal Windows 10 App au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression de la totalité des fichiers manipulés.
  • au nom d'une procédure WLangage. Cette procédure est de la forme :
    PROCEDURE <Nom de la procédure> (<Fichier en cours>,
    <Pourcentage d'avancement global>, <Pourcentage d'avancement du fichier>)

    où :
    • <Fichier en cours> correspond au nom du fichier en cours de traitement.
    • <Pourcentage d'avancement global> correspond au pourcentage d'avancement de l'ajout des fichiers dans l'archive.
    • <Pourcentage d'avancement du fichier> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive :
  • au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout de chaque fichier.
  • au format 7z, seul le paramètre <Pourcentage d'avancement global> est renseigné. Le paramètre <Pourcentage d'avancement du fichier> aura la même valeur.
WEBDEV - Code Serveur La procédure doit être une procédure serveur.
AndroidWidget AndroidJava Ce paramètre n'est pas disponible.
Mode de gestion de la jauge. Ce paramètre peut correspondre :
  • WINDEViPhone/iPadWindows MobileUniversal Windows 10 App au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression de la totalité des fichiers manipulés.
  • au nom d'une procédure WLangage. Cette procédure est de la forme :
    PROCEDURE <Nom de la procédure> (<Fichier en cours>,
    <Pourcentage d'avancement global>, <Pourcentage d'avancement du fichier>)

    où :
    • <Fichier en cours> correspond au nom du fichier en cours de traitement.
    • <Pourcentage d'avancement global> correspond au pourcentage d'avancement de l'ajout des fichiers dans l'archive.
    • <Pourcentage d'avancement du fichier> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive :
  • au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout de chaque fichier.
  • au format 7z, seul le paramètre <Pourcentage d'avancement global> est renseigné. Le paramètre <Pourcentage d'avancement du fichier> aura la même valeur.
WEBDEV - Code Serveur La procédure doit être une procédure serveur.
AndroidWidget AndroidJava Ce paramètre n'est pas disponible.
Versions 18 et supérieures
WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobileAjaxCode Utilisateur (MCU)

Ajouter une liste de fichiers contenus dans un tableau Masquer les détails

<Résultat> = zipAjouteListeFichier(<Archive> , <Liste des fichiers> [, <Gestion de la jauge>])
<Résultat> : Entier
  • 0 si l'ajout a été effectué,
  • 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> : Chaîne de caractères (avec guillemets) ou variable de type zipArchive
Nom de l'archive dans laquelle les fichiers doivent être ajoutés.
Ce nom peut correspondre :
  • soit au nom d'une archive défini avec la fonction zipOuvre ou zipCrée.
  • Versions 15 et supérieures
    WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobileAjax soit au nom d'une variable de type zipArchive.
    Nouveauté 15
    WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobileAjax soit au nom d'une variable de type zipArchive.
    WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobileAjax soit au nom d'une variable de type zipArchive.
<Liste des fichiers> : Tableau de variables de type zipFichierArchivé
Tableau de variables de type zipFichierArchivé permettant de connaître les caractéristiques des fichiers à ajouter.
<Gestion de la jauge> : Chaîne de caractères optionnelle (avec ou sans guillemets)
Versions 21 et supérieures
Mode de gestion de la jauge. Ce paramètre peut correspondre :
  • WINDEViPhone/iPadWindows MobileUniversal Windows 10 App au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression de la totalité des fichiers manipulés.
  • au nom d'une procédure WLangage. Cette procédure est de la forme :
    PROCEDURE <Nom de la procédure> (<Fichier en cours>,
    <Pourcentage d'avancement global>, <Pourcentage d'avancement du fichier>)

    où :
    • <Fichier en cours> correspond au nom du fichier en cours de traitement.
    • <Pourcentage d'avancement global> correspond au pourcentage d'avancement de l'ajout des fichiers dans l'archive.
    • <Pourcentage d'avancement du fichier> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive :
  • au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout de chaque fichier.
  • au format 7z, seul le paramètre <Pourcentage d'avancement global> est renseigné. Le paramètre <Pourcentage d'avancement du fichier> aura la même valeur.
WEBDEV - Code Serveur La procédure doit être une procédure serveur.
Nouveauté 21
Mode de gestion de la jauge. Ce paramètre peut correspondre :
  • WINDEViPhone/iPadWindows MobileUniversal Windows 10 App au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression de la totalité des fichiers manipulés.
  • au nom d'une procédure WLangage. Cette procédure est de la forme :
    PROCEDURE <Nom de la procédure> (<Fichier en cours>,
    <Pourcentage d'avancement global>, <Pourcentage d'avancement du fichier>)

    où :
    • <Fichier en cours> correspond au nom du fichier en cours de traitement.
    • <Pourcentage d'avancement global> correspond au pourcentage d'avancement de l'ajout des fichiers dans l'archive.
    • <Pourcentage d'avancement du fichier> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive :
  • au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout de chaque fichier.
  • au format 7z, seul le paramètre <Pourcentage d'avancement global> est renseigné. Le paramètre <Pourcentage d'avancement du fichier> aura la même valeur.
WEBDEV - Code Serveur La procédure doit être une procédure serveur.
Mode de gestion de la jauge. Ce paramètre peut correspondre :
  • WINDEViPhone/iPadWindows MobileUniversal Windows 10 App au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression de la totalité des fichiers manipulés.
  • au nom d'une procédure WLangage. Cette procédure est de la forme :
    PROCEDURE <Nom de la procédure> (<Fichier en cours>,
    <Pourcentage d'avancement global>, <Pourcentage d'avancement du fichier>)

    où :
    • <Fichier en cours> correspond au nom du fichier en cours de traitement.
    • <Pourcentage d'avancement global> correspond au pourcentage d'avancement de l'ajout des fichiers dans l'archive.
    • <Pourcentage d'avancement du fichier> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive :
  • au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout de chaque fichier.
  • au format 7z, seul le paramètre <Pourcentage d'avancement global> est renseigné. Le paramètre <Pourcentage d'avancement du fichier> aura la même valeur.
WEBDEV - Code Serveur La procédure doit être une procédure serveur.
Nouveauté 18
WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobileAjaxCode Utilisateur (MCU)

Ajouter une liste de fichiers contenus dans un tableau Masquer les détails

<Résultat> = zipAjouteListeFichier(<Archive> , <Liste des fichiers> [, <Gestion de la jauge>])
<Résultat> : Entier
  • 0 si l'ajout a été effectué,
  • 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> : Chaîne de caractères (avec guillemets) ou variable de type zipArchive
Nom de l'archive dans laquelle les fichiers doivent être ajoutés.
Ce nom peut correspondre :
  • soit au nom d'une archive défini avec la fonction zipOuvre ou zipCrée.
  • Versions 15 et supérieures
    WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobileAjax soit au nom d'une variable de type zipArchive.
    Nouveauté 15
    WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobileAjax soit au nom d'une variable de type zipArchive.
    WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobileAjax soit au nom d'une variable de type zipArchive.
<Liste des fichiers> : Tableau de variables de type zipFichierArchivé
Tableau de variables de type zipFichierArchivé permettant de connaître les caractéristiques des fichiers à ajouter.
<Gestion de la jauge> : Chaîne de caractères optionnelle (avec ou sans guillemets)
Versions 21 et supérieures
Mode de gestion de la jauge. Ce paramètre peut correspondre :
  • WINDEViPhone/iPadWindows MobileUniversal Windows 10 App au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression de la totalité des fichiers manipulés.
  • au nom d'une procédure WLangage. Cette procédure est de la forme :
    PROCEDURE <Nom de la procédure> (<Fichier en cours>,
    <Pourcentage d'avancement global>, <Pourcentage d'avancement du fichier>)

    où :
    • <Fichier en cours> correspond au nom du fichier en cours de traitement.
    • <Pourcentage d'avancement global> correspond au pourcentage d'avancement de l'ajout des fichiers dans l'archive.
    • <Pourcentage d'avancement du fichier> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive :
  • au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout de chaque fichier.
  • au format 7z, seul le paramètre <Pourcentage d'avancement global> est renseigné. Le paramètre <Pourcentage d'avancement du fichier> aura la même valeur.
WEBDEV - Code Serveur La procédure doit être une procédure serveur.
Nouveauté 21
Mode de gestion de la jauge. Ce paramètre peut correspondre :
  • WINDEViPhone/iPadWindows MobileUniversal Windows 10 App au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression de la totalité des fichiers manipulés.
  • au nom d'une procédure WLangage. Cette procédure est de la forme :
    PROCEDURE <Nom de la procédure> (<Fichier en cours>,
    <Pourcentage d'avancement global>, <Pourcentage d'avancement du fichier>)

    où :
    • <Fichier en cours> correspond au nom du fichier en cours de traitement.
    • <Pourcentage d'avancement global> correspond au pourcentage d'avancement de l'ajout des fichiers dans l'archive.
    • <Pourcentage d'avancement du fichier> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive :
  • au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout de chaque fichier.
  • au format 7z, seul le paramètre <Pourcentage d'avancement global> est renseigné. Le paramètre <Pourcentage d'avancement du fichier> aura la même valeur.
WEBDEV - Code Serveur La procédure doit être une procédure serveur.
Mode de gestion de la jauge. Ce paramètre peut correspondre :
  • WINDEViPhone/iPadWindows MobileUniversal Windows 10 App au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression de la totalité des fichiers manipulés.
  • au nom d'une procédure WLangage. Cette procédure est de la forme :
    PROCEDURE <Nom de la procédure> (<Fichier en cours>,
    <Pourcentage d'avancement global>, <Pourcentage d'avancement du fichier>)

    où :
    • <Fichier en cours> correspond au nom du fichier en cours de traitement.
    • <Pourcentage d'avancement global> correspond au pourcentage d'avancement de l'ajout des fichiers dans l'archive.
    • <Pourcentage d'avancement du fichier> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive :
  • au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout de chaque fichier.
  • au format 7z, seul le paramètre <Pourcentage d'avancement global> est renseigné. Le paramètre <Pourcentage d'avancement du fichier> aura la même valeur.
WEBDEV - Code Serveur La procédure doit être une procédure serveur.
WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobileAjaxCode Utilisateur (MCU)

Ajouter une liste de fichiers contenus dans un tableau Masquer les détails

<Résultat> = zipAjouteListeFichier(<Archive> , <Liste des fichiers> [, <Gestion de la jauge>])
<Résultat> : Entier
  • 0 si l'ajout a été effectué,
  • 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> : Chaîne de caractères (avec guillemets) ou variable de type zipArchive
Nom de l'archive dans laquelle les fichiers doivent être ajoutés.
Ce nom peut correspondre :
  • soit au nom d'une archive défini avec la fonction zipOuvre ou zipCrée.
  • Versions 15 et supérieures
    WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobileAjax soit au nom d'une variable de type zipArchive.
    Nouveauté 15
    WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobileAjax soit au nom d'une variable de type zipArchive.
    WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobileAjax soit au nom d'une variable de type zipArchive.
<Liste des fichiers> : Tableau de variables de type zipFichierArchivé
Tableau de variables de type zipFichierArchivé permettant de connaître les caractéristiques des fichiers à ajouter.
<Gestion de la jauge> : Chaîne de caractères optionnelle (avec ou sans guillemets)
Versions 21 et supérieures
Mode de gestion de la jauge. Ce paramètre peut correspondre :
  • WINDEViPhone/iPadWindows MobileUniversal Windows 10 App au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression de la totalité des fichiers manipulés.
  • au nom d'une procédure WLangage. Cette procédure est de la forme :
    PROCEDURE <Nom de la procédure> (<Fichier en cours>,
    <Pourcentage d'avancement global>, <Pourcentage d'avancement du fichier>)

    où :
    • <Fichier en cours> correspond au nom du fichier en cours de traitement.
    • <Pourcentage d'avancement global> correspond au pourcentage d'avancement de l'ajout des fichiers dans l'archive.
    • <Pourcentage d'avancement du fichier> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive :
  • au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout de chaque fichier.
  • au format 7z, seul le paramètre <Pourcentage d'avancement global> est renseigné. Le paramètre <Pourcentage d'avancement du fichier> aura la même valeur.
WEBDEV - Code Serveur La procédure doit être une procédure serveur.
Nouveauté 21
Mode de gestion de la jauge. Ce paramètre peut correspondre :
  • WINDEViPhone/iPadWindows MobileUniversal Windows 10 App au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression de la totalité des fichiers manipulés.
  • au nom d'une procédure WLangage. Cette procédure est de la forme :
    PROCEDURE <Nom de la procédure> (<Fichier en cours>,
    <Pourcentage d'avancement global>, <Pourcentage d'avancement du fichier>)

    où :
    • <Fichier en cours> correspond au nom du fichier en cours de traitement.
    • <Pourcentage d'avancement global> correspond au pourcentage d'avancement de l'ajout des fichiers dans l'archive.
    • <Pourcentage d'avancement du fichier> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive :
  • au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout de chaque fichier.
  • au format 7z, seul le paramètre <Pourcentage d'avancement global> est renseigné. Le paramètre <Pourcentage d'avancement du fichier> aura la même valeur.
WEBDEV - Code Serveur La procédure doit être une procédure serveur.
Mode de gestion de la jauge. Ce paramètre peut correspondre :
  • WINDEViPhone/iPadWindows MobileUniversal Windows 10 App au nom d'un champ Jauge présent dans une fenêtre. Cette jauge affichera la progression de l'ajout et de la compression de la totalité des fichiers manipulés.
  • au nom d'une procédure WLangage. Cette procédure est de la forme :
    PROCEDURE <Nom de la procédure> (<Fichier en cours>,
    <Pourcentage d'avancement global>, <Pourcentage d'avancement du fichier>)

    où :
    • <Fichier en cours> correspond au nom du fichier en cours de traitement.
    • <Pourcentage d'avancement global> correspond au pourcentage d'avancement de l'ajout des fichiers dans l'archive.
    • <Pourcentage d'avancement du fichier> correspond au pourcentage d'avancement de l'ajout du fichier en cours dans l'archive.
Si vous manipulez une archive :
  • au format TAR ou TGZ (TAR.GZ), la jauge est mise à jour uniquement à la fin de l'ajout de chaque fichier.
  • au format 7z, seul le paramètre <Pourcentage d'avancement global> est renseigné. Le paramètre <Pourcentage d'avancement du fichier> aura la même valeur.
WEBDEV - Code Serveur La procédure doit être une procédure serveur.
Remarques

Condition d'utilisation

L'ajout de fichiers dans une archive ne peut être réalisé que si :
  • L'archive existe (la création d'une archive s'effectue avec la fonction zipCrée).
  • L'archive est accessible en lecture et en écriture.
  • L'archive est mono-partie.
  • La taille du fichier est inférieure à 4 Go.
Attention :
  • Le chemin complet de chaque fichier est conservé dans les archives au format ZIP ou WDZ.
  • Archives au format CAB : L'ajout de fichiers doit se faire immédiatement après la création de l'archive. Ce format ne permet pas d'ajouter des fichiers dans une archive existante.
  • Archives au format RAR : Cette fonction n'est pas disponible.
  • Archives au format 7z : L'archive est entièrement compressée à chaque appel de la fonction zipAjouteListeFichier.
Le nombre maximum de fichiers pouvant être intégrés :
  • dans un fichier WDZ : 232-1.
  • dans un fichier ZIP : 65535.
  • dans un fichier CAB : 65535.
LinuxAndroidWidget AndroidiPhone/iPadWindows MobileUniversal Windows 10 AppJava Seules les archives au format ZIP sont disponibles.
Rappel :
  • LinuxiPhone/iPadUniversal Windows 10 App Seules les archives au format ZIP, TAR et TGZ (TAR.GZ) sont disponibles.
  • AndroidWidget AndroidWindows MobileJava Seules les archives au format ZIP sont disponibles.

Niveau de compression

Par défaut, les fichiers ajoutés dans une archive au format Zip sont compressés. Il est possible de modifier le niveau de compression des fichiers ajoutés dans une archive grâce à la fonction zipNiveauCompression.

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 ou le fichier est en cours d'utilisation. Si le fichier à insérer est un fichier de données HFSQL, il doit être fermé avec le code suivant :
    HFerme(<Nom Fichier>)
    Multitâche(<Attente>) // Attend la fermeture effective du fichier
  • 3 : L'archive est corrompue.
  • 4 : Le chemin n'existe pas dans l'archive.
  • 5 : Impossible d'écrire dans l'archive.
  • 7 : Le fichier est déjà présent dans l'archive.
  • 8 : Une archive ne peut pas être ajoutée à elle-même. Par exemple, l'archive "MonArchive" ne peut pas être ajoutée à l'archive "MonArchive".
Le message correspondant au code d'erreur peut être connu grâce à la fonction zipMsgErreur.

Ajout d'un fichier déjà présent dans l'archive

L'ajout d'un fichier déjà présent dans une archive provoque une erreur. Un fichier est identifié selon son chemin mémorisé. Il est donc impossible d'ajouter à l'archive deux fichiers de même nom ayant le même chemin relatif.

Indice des fichiers dans l'archive

Lors de l'ajout d'un fichier dans une archive, un indice est automatiquement attribué au fichier. Cet indice correspond à l'ordre d'intégration des fichiers dans l'archive. Pour sélectionner un fichier de l'archive, il est possible d'utiliser :
  • Soit l'indice de l'élément (remarque : l'indice d'un élément peut être connu grâce à la fonction zipChercheFichier).
  • Soit le chemin mémorisé de l'élément.
WINDEVEtats et RequêtesWindows MobileCode Utilisateur (MCU)

Jauge

Sous Windows, pour visualiser la progression de l'ajout et de la compression des fichiers, branchez un événement sur le message JaugeCompactage (1174). A la réception de ce message :
  • la variable _EVE.wParam contient le pourcentage de compression du fichier en cours
  • la variable _EVE.lParam contient le pourcentage de compression de l'ensemble des fichiers.
Attention : Cet événement n'est pas supporté si l'appel à la fonction zipAjouteListeFichier est réalisé dans un thread secondaire.
Versions 21 et supérieures
A partir de la version 21, il est possible d'utiliser le paramètre <Gestion de la jauge> pour gérer la progression de l'ajout des fichiers.
Nouveauté 21
A partir de la version 21, il est possible d'utiliser le paramètre <Gestion de la jauge> pour gérer la progression de l'ajout des fichiers.
A partir de la version 21, il est possible d'utiliser le paramètre <Gestion de la jauge> pour gérer la progression de l'ajout des fichiers.
Composante : wd240zip.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire