PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Paramètres et
  • Création de répertoires lors de la copie
  • Gestion de la progression de la copie
  • É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
Copie un ou plusieurs fichiers :
  • présents sur le poste en cours vers le Terminal Mobile (Pocket PC) connecté.
  • présents sur le Terminal Mobile (Pocket PC) connecté vers le poste en cours.
  • présents sur le Terminal Mobile (Pocket PC) connecté vers un autre répertoire du Terminal Mobile (Pocket PC).
Remarques :
  • La copie de fichiers peut être réalisée uniquement si une connexion entre le poste en cours et le Terminal Mobile (Pocket PC) 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
// Copie du fichier "Image.GIF" présent dans le répertoire en cours
// du poste en cours vers le Terminal Mobile connecté
// Si ce fichier existe déjà sur le Terminal Mobile,
// ce fichier est écrasé (constante ceEcrase)
ResCopie = ceCopieFichier(cePCVersPocket + ceEcrase, "Image.GIF", "\MesImages\Photo.GIF")
// Problème rencontré ?
SI ResCopie = Vrai ALORS
Info("La copie a été effectuée.")
SINON
Erreur(ErreurInfo())
FIN
// Copie les fichiers présents dans le répertoire "\MesImages"
// sur le Terminal Mobile (Pocket PC) connecté vers le poste en cours
// Les sous-répertoires et leurs fichiers sont
// pris en compte (constante ceRécursif)
ResCopie = ceCopieFichier(cePocketVersPC + ceRécursif, ...
"\MesImages\*.*", "C:\MesFichiers\", GestionProgression)
// -- Code de la procédure GestionProgression
PROCEDURE GestionProgression(TotalOctet, TotalTransmis)
// Affiche la progression de la copie dans la barre de message
Message("Copie en cours : " + TotalTransmis + " / " + TotalOctet)
RENVOYER Vrai
Syntaxe
<Résultat> = ceCopieFichier(<Mode et type de copie> , <Fichier source> , <Fichier ou répertoire destination> [, <Nom de la procédure>])
<Résultat> : Booléen
  • Vrai si le ou les fichiers ont été copiés,
  • Faux dans le cas contraire. En cas d'erreur, il est possible de connaître le détail de l'erreur grâce à la fonction ErreurInfo.
<Mode et type de copie> : Constantes de type Entier
Mode de copie à effectuer :
cePCVersPocketCopie du poste en cours vers le Terminal Mobile (Pocket PC) connecté.
cePocketVersPCCopie du Terminal Mobile (Pocket PC) connecté vers le poste en cours.
cePocketVersPocketCopie du Terminal Mobile connecté vers un autre répertoire du Terminal Mobile.

Type de copie à effectuer (constante optionnelle) :
ceEcraseForce le remplacement du ou des fichiers existants par le ou les fichiers copiés.
ceRécursifCopie récursive de fichiers : les sous-répertoires et leurs fichiers sont également copiés.

Par défaut, aucune option de copie n'est sélectionnée.
<Fichier source> : Chaîne de caractères (avec guillemets)
Nom et chemin complet du ou des fichiers à copier (260 caractères maximum).
Les caractères jokers (*, ?) sont autorisés aussi bien dans le nom du fichier que dans le chemin.
<Fichier ou répertoire destination> : Chaîne de caractères (avec guillemets)
Fichier et/ou répertoire destination (260 caractères maximum). Ce paramètre peut correspondre à :
  • un nom et un chemin complet de fichier.
  • un chemin complet, uniquement dans le cas d'une copie avec caractères jokers.
Si ce paramètre correspond à un nom de répertoire, ce nom peut être terminé indifféremment par "\" ou non.
<Nom de la procédure> : Chaîne de caractères optionnelles (avec ou sans guillemets)
Nom d'une procédure WLangage appelée automatiquement pour contrôler la progression de la copie.
Cette procédure ne peut pas être appelée si la constante cePocketVersPocket est utilisée.
Remarques

Paramètres <Fichier source> et <Fichier ou répertoire destination>

Si le fichier manipulé correspond à un fichier présent sur le poste PC en cours, ces paramètres peuvent correspondre :
  • soit à un nom de fichier. Ce fichier sera automatiquement recherché dans le répertoire en cours (connu avec la fonction fRepEnCours).
  • soit à un nom de fichier avec son chemin (complet ou relatif). Un chemin de type UNC peut être utilisé.
Si le fichier manipulé correspond à un fichier présent sur le Terminal Mobile connecté, ces paramètres doivent correspondre obligatoirement au nom et au chemin complet du fichier à manipuler.

Création de répertoires lors de la copie

  • Si un des répertoires du chemin destination n'existe pas, il est automatiquement créé.
  • Si le fichier source correspond à l'ensemble des fichiers d'un répertoire (par exemple, "C:\Temp\*.*"), il faut utiliser la constante ceRécursif afin de créer les sous-répertoires dans la destination (et copier leur contenu).

Gestion de la progression de la copie

Pour contrôler la progression de la copie, la fonction ceCopieFichier peut appeler automatiquement la procédure <Nom de la procédure> à intervalles réguliers (tous les 100 Ko).
Cette procédure est déclarée de la manière suivante :
PROCEDURE <Nom de la procédure>(<Taille totale>, <Taille transférée>, <Nom du fichier>)
  • <Taille totale> est un entier correspondant à la taille totale du fichier en cours de copie.
  • <Taille transférée> est un entier correspondant au nombre d'octets déjà copiés.
  • <Nom du fichier> est une chaîne de caractères correspondant au nom du fichier en cours de copie.
Il est possible dans cette procédure :
  • d'afficher une jauge de progression,
  • de savoir si le transfert est terminé (<Taille totale>=<Taille transférée>).
Par défaut, la fonction ceCopieFichier ne peut pas être interrompue tant qu'il reste des fichiers à copier. Pour forcer l'interruption de la copie, il faut utiliser la ligne suivante dans la procédure <Nom de la procédure> :
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> ne retourne aucune valeur (ni Vrai, ni Faux), une erreur est générée.
Rappel : Cette procédure ne peut pas être appelée si la constante cePocketVersPocket est utilisée.

Équivalence

Le fonctionnement de la fonction ceCopieFichier est équivalent au fonctionnement de la fonction fCopieFichier.
Seule différence :
  • la fonction ceCopieFichier manipule des fichiers présents sur le Terminal mobile à partir d'une application WINDEV standard.
  • la fonction fCopieFichier manipule des fichiers présents sur le Terminal Mobile 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