|
|
|
|
- Paramètres et
- Création de répertoires lors de la copie
- Gestion de la progression de la copie
- Équivalence
ceCopieFichier (Fonction) En anglais : ceCopyFile 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).
- Cette fonction est disponible en mode 64 bits.
// 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> [, <Procédure WLangage>])
<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 :
| | cePCVersPocket | Copie du poste en cours vers le Terminal Mobile (Pocket PC) connecté. | cePocketVersPC | Copie du Terminal Mobile (Pocket PC) connecté vers le poste en cours. | cePocketVersPocket | Copie du Terminal Mobile connecté vers un autre répertoire du Terminal Mobile. |
Type de copie à effectuer (constante optionnelle) :
| | ceEcrase | Force le remplacement du ou des fichiers existants par le ou les fichiers copiés. | ceRécursif | Copie 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. <Procédure WLangage> : Nom de procédure 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 <Procédure WLangage> à 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 <Procédure WLangage> : Dans les autres cas (pour poursuivre le parcours), la procédure <Procédure WLangage> DOIT renvoyer Vrai. Si la procédure <Procédure WLangage> 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. 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.
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|