PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE


  • Cas particuliers
  • Procédure WLangage
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
Déclenche la surveillance d'un fichier. En cas de modification du fichier, une procédure spécifique est exécutée dans un thread.
Exemple
// Nom du fichier à surveiller
sNomFichier est une chaîne = "C:\Temp\MonRep\MonFichier.extension"
// La procédure TraiteModification sera appelée lorsque le fichier
// "C:\Temp\MonRep\MonFichier.extension" sera modifié.
SI fSurveilleFichier(sNomFichier, TraiteModification, ...
fsCréationFichier + fsModificationFichier + fsSuppressionFichier + ...
fsRenommage) ALORS
// On informe l'utilisateur de la mise sous surveillance du fichier
Info("La mise sous surveillance du fichier " + sNomFichier + " a réussi.")
SINON
// On informe l'utilisateur de l'échec de la mise sous surveillance du fichier
Info("La mise sous surveillance du fichier " + sNomFichier + " a échoué.")
FIN
 
// Code de la procédure
PROCÉDURE TraiteModification(sNomComplet, 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, sNomComplet, sNomFichier, ...
sDesignationAction, sAncienNomFichier)
Syntaxe
<Résultat> = fSurveilleFichier(<Nom du fichier> , <Nom de la procédure> [, <Modifications à notifier>])
<Résultat> : Booléen
  • Vrai si la surveillance du fichier est activée,
  • Faux dans le cas contraire. Pour plus de détails sur l'erreur, utilisez la fonction ErreurInfo.
<Nom du fichier> : Chaîne de caractères (avec guillemets)
Nom complet du fichier à surveiller.
<Nom de la procédure> : Chaîne de caractères (avec ou sans guillemets)
Nom de la procédure WLangage (également nommée "callback") appelée lors d'un changement sur le fichier spécifié.
Cette procédure est de la forme :
PROCEDURE <Nom de la procédure>([<Nom complet du fichier modifié>
[, <Nom du fichier modifié> [, <Action> [, <Ancien nom du fichier>]]]])
où :
  • <Nom complet du fichier modifié> : chaîne de caractères indiquant le chemin complet du fichier observé.
  • <Nom du fichier modifié> : chaîne de caractères indiquant le nom du fichier observé (après modification).
  • <Action> : Constante de type Entier pouvant prendre les valeurs suivantes :
    fsCréationFichierCréation du fichier <Nom du fichier modifié>.
    fsModificationFichierModification du fichier <Nom du fichier modifié>.
    fsRenommageRenommage du fichier <Nom du fichier modifié>.
    fsSuppressionFichierSuppression du fichier <Nom du fichier modifié>.
  • <Ancien nom> : Ancien nom du fichier modifié si l'action effectuée est un renommage.
Versions 22 et supérieures
Remarque : Cette procédure peut être une procédure interne.
Nouveauté 22
Remarque : Cette procédure peut être une procédure interne.
Remarque : Cette procédure peut être une procédure interne.
<Modifications à notifier> : Constante ou combinaison de constantes optionnelle de type Entier
Modifications du fichier à surveiller et pour lesquelles la procédure doit être exécutée :
fsCréationFichierCréation du fichier <Nom du fichier modifié>.
fsModificationFichierModification du fichier <Nom du fichier modifié>.
fsRenommageRenommage du fichier <Nom du fichier modifié>.
fsSuppressionFichierSuppression du fichier <Nom du fichier modifié>.
fsToutSurveillance de toutes les actions possibles. Correspond à fsCréationFichier + fsModificationFichier + fsRenommage + fsSuppressionFichier.
Remarques

Cas particuliers

  • Pour arrêter la surveillance du fichier, utilisez les fonctions fSurveilleStop et fSurveilleStopTout.
  • Pour surveiller les modifications effectuées sur le contenu d'un répertoire, utilisez la fonction fSurveilleRépertoire.
  • Limitations :
    • Seuls 5 fichiers peuvent être surveillés simultanément.
    • Il n'est pas possible de surveiller un fichier situé à la racine d'un disque (pour des raisons de performances).

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 : wd240std.dll
Version minimum requise
  • Version 18
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire