PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Procédure manipulant chaque fichier ou répertoire listé
  • Interruption de ceListeFichier
  • Gestion des erreurs
  • Équivalence
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
ceListeFichier (Fonction)
En anglais : ceListFile
Liste les fichiers d'un répertoire (et de ses sous-répertoires) et retourne le nombre de fichiers listés. Le répertoire manipulé est présent sur le Terminal Mobile (Pocket PC) connecté au poste en cours.
Pour chaque fichier listé, la fonction ceListeFichier appelle automatiquement une procédure spécifique écrite en WLangage. Cette procédure permet de manipuler le fichier en cours.
Remarques :
  • La fonction ceListeFichier peut être utilisée uniquement si une connexion entre le poste en cours et le Terminal Mobile est établie (fonction ceConnecte).
  • Versions 20 et supérieures
    Cette fonction est disponible en mode 64 bits.
    Nouveauté 20
    Cette fonction est disponible en mode 64 bits.
    Cette fonction est disponible en mode 64 bits.
Exemple
// Liste les fichiers de type ".BMP" présents dans "\MesDocuments".
// La procédure AttributFichier retourne le nombre de fichiers en lecture seule.
ResListeFichier = ceListeFichier("\MesDocuments\*.BMP", AttributFichier)
Syntaxe
<Résultat> = ceListeFichier(<Chemin et nom générique des fichiers> , <Nom de la procédure> [, <Pointeur>])
<Résultat> : Entier
Nombre de fichiers listés.
<Chemin et nom générique des fichiers> : Chaîne de caractères (avec guillemets)
Chemin et nom générique des fichiers à lister. Les caractères génériques (* et ?) sont autorisés.
<Nom de la procédure> : Chaîne de caractères (avec ou sans guillemets)
Nom de la procédure WLangage ("callback") appelée pour chaque fichier et répertoire listé. Cette procédure permet de manipuler le fichier ou le répertoire en cours.
Cette procédure est de la forme :
PROCEDURE <Nom de la procédure>(<Chemin>, <Nom du fichier>, <Change>,
<Pointeur de la procédure>)

Les paramètres de cette procédure sont optionnels.
Il n'est pas nécessaire de passer des paramètres à cette procédure. En effet, ces paramètres sont renseignés automatiquement à chaque fichier traité.
<Pointeur> : Entier optionnel
Pointeur passé à la procédure <Nom de la procédure>.
Remarques

Procédure manipulant chaque fichier ou répertoire listé

Pour chaque fichier trouvé, la fonction ceListeFichier appelle automatiquement la procédure <Nom de la procédure>. Cette procédure est une procédure locale ou globale de WINDEV.
Pour créer cette procédure :
  1. Créez une procédure globale (option "Insertion .. Nouvelle procédure globale" de l'éditeur de code).Créez une procédure globale sous l'éditeur de code : sous le volet "Code", dans le groupe "Procédures", déroulez "Nouveau" et sélectionnez "Nouvelle procédure globale".
  2. Complétez la déclaration de la procédure de la manière suivante :
    PROCEDURE <Nom de la procédure> (<Chemin>, <Nom du fichier>, <Change>,
    <Pointeur de la procédure>)
    • <Chemin> est le chemin du fichier ou du répertoire manipulé (il contient toujours un "\" à la fin; par exemple, "\WINDEV\").
    • <Nom du fichier> est une chaîne de caractères contenant le nom du fichier trouvé, chaîne vide ("") si <Chemin> correspond à un nouveau fichier listé.
    • <Change> est une constante qui vaut :
      • cePremierFichier lorsque le fichier est le premier listé dans le <Chemin>,
      • ceChangeRépertoire lorsque le fichier est le premier listé dans un sous-répertoire de <Chemin> (cela signifie qu'il y a eu changement de répertoire),
      • ceRépertoire lorsque <Chemin> correspond à un nouveau fichier listé,
      • ceFichier dans tous les autres cas.
      Voici les différentes valeurs pouvant être prises par <Change> :
      Fichier en cours<Change>
      Rep\Fichier 1cePremierFichier
      Rep\Fichier nceFichier
      Rep\SousRep 1\ceRépertoire
      Rep\SousRep 1\Fichier 1ceChangeRépertoire
      Rep\SousRep 1\Fichier mceFichier
      Rep\SousRep 2\ceRépertoire
      Rep\SousRep 2\Fichier 1ceChangeRépertoire
      Rep\SousRep 2\Fichier xceFichier
  • <Pointeur de la procédure> est un entier qui vaut la valeur passé dans le paramètre <Pointeur> de la fonction ceListeFichier. Si le paramètre <Pointeur> n'est pas précisé, <Pointeur> vaut 0.
Pour récupérer la valeur du <Pointeur de la procédure>, affectez la valeur du <Pointeur de la procédure> à la valeur du <Pointeur> dans la procédure avec la fonction Transfert (voir Exemple).

Interruption de ceListeFichier

Tant qu'il y a des fichiers à parcourir, la fonction ceListeFichier ne peut pas être interrompue. Pour forcer l'interruption du parcours, utilisez la ligne suivante dans la procédure <Nom de la procédure> :
RENVOYER Faux
Dans ce cas, la fonction ceListeFichier retourne le nombre de fichiers parcourus jusqu'à l'appel de "Renvoyer Faux".
Dans les autres cas (pour poursuivre le parcours), la procédure <Nom de la procédure> DOIT renvoyer Vrai.
Si la procédure <Nom de la procédure> retourne aucune valeur (ni Vrai, ni Faux), une erreur est générée.

Gestion des erreurs

Attention : La fonction ceListeFichier ne retourne pas de code d'erreur. Pour savoir si cette fonction a généré une erreur, utilisez la fonction ErreurInfo avec la constante errMessage.

Équivalence

Le fonctionnement de ceListeFichier est équivalent au fonctionnement de fListeFichier.
Seule différence :
  • la fonction ceListeFichier manipule un répertoire présent sur le Terminal Mobile (Pocket PC) à partir d'une application WINDEV standard.
  • la fonction fListeFichier manipule un répertoire présent sur le Terminal Mobile (Pocket PC) uniquement à partir d'une application WINDEV Mobile.
Composante : wd240ce.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire