PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Nouveauté WINDEV, WEBDEV, WINDEV Mobile 22 !
  • Procédure WLangage
  • Cas particuliers
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
HSurveille (Fonction)
En anglais : HTrack
HFSQL Client/ServeurDisponible uniquement avec ce type de connexion
Déclenche la surveillance des actions d'écriture (ajout, modification ou suppression) effectuées sur un fichier d’un serveur HFSQL. En cas de modification, une procédure spécifique peut être déclenchée.
Cette surveillance peut être arrêtée via la fonction HSurveilleStop.
Exemple
// Lance la surveillance du fichier Commande
// La procédure TraiteCommande est appelée pour tout ajout d'enregistrement dans le fichier
HSurveille(Commande, TraiteCommande, hNumEnrTous, hsAjout)
Syntaxe
<Résultat> = HSurveille(<Nom du fichier> , <Nom de la procédure> [, <Numéro d'enregistrement> [, <Action à surveiller>]])
<Résultat> : Booléen
  • Vrai si la surveillance du fichier de données 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 optionnelle (avec ou sans guillemets)
Nom du fichier de données HFSQL à manipuler. Ce fichier de données est associé à une connexion et à un serveur.
Si ce paramètre correspond à une chaîne vide (""), la fonction HSurveille manipule le dernier fichier de données utilisé par la dernière fonction de gestion HFSQL (fonction commençant par la lettre H).
<Nom de la procédure> : Chaîne de caractères (avec ou sans guillemets)
Nom de la procédure WLangage (également appelée "callback") appelée lors d'un changement sur le fichier de données spécifié. Cette procédure est de la forme :
PROCEDURE <Nom de la procédure>(<Nom du fichier modifié>,
<Numéro enregistrement modifié>, <Action>)

où :
  • <Nom du fichier modifié> est une source de données correspondant au fichier HFSQL modifié,
  • <Numéro enregistrement modifié> correspond au numéro de l'enregistrement modifié (équivalent du numéro renvoyé par la fonction HNumEnr),
  • <Action> correspond à l'action qui a déclenché la procédure. Les valeurs possibles sont :
    hsAjoutProcédure lancée suite à l'ajout d'un enregistrement dans le fichier de données.
    hsModificationProcédure lancée suite à la modification d'un enregistrement dans le fichier de données.
    hsRayeProcédure lancée suite au rayage d'un enregistrement dans le fichier de données.
    hsSuppressionProcédure lancée suite à la suppression d'un enregistrement dans le fichier de données.
<Numéro d'enregistrement> : Entier optionnel
  • Numéro de l'enregistrement à surveiller.
  • Constante hNumEnrTous pour surveiller tous les enregistrements du fichier de données (c'est-à-dire tout le fichier de données).
<Action à surveiller> : Constante ou combinaison de constantes optionnelle
Actions à surveiller pour lesquelles la procédure doit être lancée :
hsAjoutSurveille les opérations d'ajout d'enregistrements.
hsModificationSurveille les opérations de modification d'enregistrements.
hsRayeSurveille les opérations de rayage d'enregistrements.
hsSuppressionSurveille les opérations de suppression d'enregistrements.
Remarques

Procédure WLangage

La procédure WLangage est appelée dans le thread principal de l'application, avec le contexte HFSQL correspondant à la procédure :
  • Si la procédure est une procédure locale d’une fenêtre utilisant un contexte indépendant, le contexte utilisé sera celui de la fenêtre.
  • Si la procédure appartient à un composant utilisant un contexte indépendant, le contexte utilisé sera celui du composant.
Attention :
La procédure associée à la fonction HSurveille peut être appelée à n'importe quel moment dans l'application.
Si la procédure effectue des parcours HFSQL ou des déplacements dans des fichiers de données, cela impactera l'application (comme les timers).
Il peut donc être nécessaire d'utiliser les fonctions HSauvePosition et HRetourPosition pour sauvegarder les contextes des fichiers manipulés.
Il ne faut pas utiliser la fonction Multitâche dans le code de la procédure.

Cas particuliers

La surveillance est définie pour un fichier de données et une connexion :
  • Si le nom physique ou la connexion associés au nom logique du fichier de données change, le fichier surveillé par le serveur reste celui indiqué au moment de l'appel de la fonction HSurveille.
  • Si la connexion est fermée, la surveillance est automatiquement arrêtée.
Pour arrêter la surveillance du fichier de données, utilisez la fonction HSurveilleStop.
Composantes
WINDEVWEBDEV - Code ServeurEtats et Requêtes wd220hf.dll
Linux wd220hf.so
Version minimum requise
  • Version 22
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire