DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des fichiers externes
  • Cas particuliers
  • Procédure WLangage
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Détecte les modifications effectuées sur le contenu d'un répertoire. Seules les modifications effectuées sur les fichiers présents dans le répertoire sont détectées. En cas de modification, une procédure spécifique est exécutée dans un thread.
Exemple
// Nom du répertoire à surveiller
sNomRepertoire est une chaîne = "C:\Temp\MonRep"
// La procédure fSurveilleRépertoire_Callback sera appelée
// lorsqu'un fichier ou un répertoire contenu dans le répertoire "C:\Temp\MonRep" sera modifié.  
SI fSurveilleRépertoire(sNomRepertoire, fSurveilleRépertoire_Callback, fsCréationFichier + ...
fsModificationFichier + fsSuppressionFichier + fsRenommage) ALORS
// On informe l'utilisateur de la mise sous surveillance du répertoire
Info("La mise sous surveillance du répertoire " + sNomRepertoire + " a réussi.")
SINON
// On informe l'utilisateur de l'échec de la mise sous surveillance du répertoire
Info("La mise sous surveillance du répertoire " + sNomRepertoire + " a échoué.")
FIN
// Code de la procédure
PROCÉDURE fSurveilleRépertoire_Callback(sNomRepertoire, sNomFichier, nAction, sAncienNomFichier)
ExécuteThreadPrincipal(AjoutTable, sNomRepertoire, sNomFichier, nAction, sAncienNomFichier)
// Procédure qui agit sur le thread principal
PROCÉDURE AjoutTable(sNomRepertoire, sNomFichier, nAction, sAncienNomFichier)
 
sDesignationAction est une chaîne
// La désignation de l'action subie dépend de nAction
SELON nAction
CAS fsCréationFichier : sDesignationAction = "Création de fichier"
CAS fsSuppressionFichier : sDesignationAction = "Suppression de fichier"
CAS fsModificationFichier : sDesignationAction = "Modification de fichier"
CAS fsRenommage : sDesignationAction = "Renommage de fichier"
FIN
// Ajout d'une ligne contenant les informations de la modification
// dans la table TABLE_MODIFICATIONS
TableAjouteLigne(TABLE_MODIFICATIONS, sNomRepertoire, sNomFichier, ...
sDesignationAction, sAncienNomFichier)
Syntaxe
<Résultat> = fSurveilleRépertoire(<Répertoire à surveiller> , <Procédure WLangage> [, <Modifications à notifier> [, <Sous-répertoire>]])
<Résultat> : Booléen
  • Vrai si la surveillance du répertoire est activée,
  • Faux dans le cas contraire. Pour plus de détails sur l'erreur, utilisez la fonction ErreurInfo.
<Répertoire à surveiller> : Chaîne de caractères
Nom complet du répertoire à surveiller.
<Procédure WLangage> : Nom de procédure
Nom de la procédure WLangage (également nommée "callback") appelée lors d'un changement dans le répertoire spécifié.
Pour plus de détails sur cette procédure, consultez Paramètres de la procédure utilisée par la fonction fSurveilleRépertoire.
<Modifications à notifier> : Constante ou combinaison de constantes optionnelle de type Entier
Modifications du contenu du répertoire à surveiller et pour lesquelles la procédure doit être exécutée :
fsCréationFichierCréation d'un fichier ou d'un répertoire.
fsModificationFichierModification d'un fichier ou d'un répertoire.
fsRenommageRenommage d'un fichier ou d'un répertoire.
fsSuppressionFichierSuppression d'un fichier ou d'un répertoire.
fsToutSurveillance de toutes les actions possibles. Correspond à fsCréationFichier + fsModificationFichier + fsRenommage + fsSuppressionFichier.
<Sous-répertoire> : Booléen
  • Vrai (valeur par défaut) pour traiter les sous-répertoires.
  • Faux dans le cas contraire.
Remarques

Cas particuliers

  • La fonction fSurveilleRépertoire surveille uniquement le contenu du répertoire. Les changements de nom ou d'emplacement du répertoire ne sont pas pris en compte.
  • Pour arrêter la surveillance du répertoire, utilisez les fonctions fSurveilleStop et fSurveilleStopTout.
  • Pour surveiller les modifications effectuées sur un fichier, utilisez la fonction fSurveilleFichier.
  • Limitation : Seuls 5 répertoires peuvent être surveillés simultanément.

Procédure WLangage

La procédure WLangage est exécutée dans un thread WLangage.
Attention : Il n'est pas possible d'exécuter dans les threads les traitements suivants :
Pour plus de détails sur la gestion des threads, consultez Gestion des threads.
Composante : wd290std.dll
Version minimum requise
  • Version 18
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

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