DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Propriétés WLangage / Propriétés des fenêtres, des pages et de leurs champs
  • Cas des événements optionnels
  • Cas des événements attendant des paramètres
  • Utilisation du mot-clé MoiMême
  • Sortir de l'enchaînement des procédures
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
La propriété Traitement permet de modifier les traitements à exécuter par les événements disponibles sur un champ, une fenêtre, une page, un état, ...
Plusieurs types de manipulations sont possibles :
  • L'opérateur '=' supprime tous les traitements et toutes les procédures précédemment attachées à l'événement et les remplace par la procédure spécifiée.
  • L'opérateur '+=' ajoute la procédure spécifiée à la suite du traitement initial et des procédures ajoutées précédemment.
  • Les propriétés Avant et Après permettent de gérer plus finement les procédures à exécuter.
  • Il est possible de sortir de l'enchaînement des procédures grâce à la fonction DonneFocusEtRetourUtilisateur.
Exemple
// Renseigne le traitement à exécuter sur un clic
BTN_BOUTON1.Traitement[trtClic] = maProcédure1
 
// Ajoute une procédure à exécuter sur un clic
BTN_BOUTON1.Traitement[trtClic] += maProcédure2
 
// Ajoute une procédure à exécuter avant le traitement de clic
BTN_BOUTON1.Traitement[trtClic].Avant += maProcédure3
Syntaxe
<Elément>.Traitement[<Type de traitement>] = <Nom de la procédure>
<Elément> : Chaîne de caractères
Nom de l'élément à manipuler :
  • Nom du champ ou nom de la variable de type Champ à manipuler.
  • Nom de la page à manipuler.
  • Nom de la fenêtre à manipuler.
  • Nom de l'état à manipuler.
<Type de traitement> : Constante de type Entier
Traitement à manipuler :
trtActionCode d'action d'un champ Composant Web.
trtAffectationValeurCode d'affectation de la propriété Valeur d'un champ Composant Web.
trtAffichageLigneCode d'affichage de ligne (champ Table uniquement).

trtAffichageMenuContextuelCode optionnel d'affichage du menu contextuel.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtAjoutCarteKanbanCode d'ajout d'une carte dans un champ Kanban.
trtAjouteDiagFormeCode d'ajout d'une forme dans un champ Editeur de diagrammes.
trtAjoutJetonCode d'ajout d'un jeton dans un champ de saisie de type "Jetons de texte".
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtAjoutWidgetCode d'ajout d'un Widget dans un champ Tableau de bord.
trtAprèsChargementPageHTMLCode "Après chargement de la page HTML" d'un champ d'affichage HTML.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtApresImpressionCode "Après Impression" d'un bloc dans un état.
trtAprèsOuvertureDocumentCode "Après ouverture du document" d'un champ Traitement de texte, d'un champ Editeur d'images, d'un champ Tableur ou d'un champ Lecteur PDF.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtAvantChargementPageHTMLCode "Avant chargement de la page HTML" d'un champ d'affichage HTML.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtAvantCréationRdvAgendaCode "Avant création du rendez-vous" d'un champ Agenda.
trtAvantCréationRdvPlanningCode "Avant création du rendez-vous" d'un champ Planning.
trtAvantFermetureDocumentCode "Avant fermeture du document" d'un champ Traitement de texte, d'un champ Editeur d'images, d'un champ Tableur ou d'un champ Lecteur PDF.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtAvantFermetureFenêtreCode "Autorisation de fermeture".
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtAvantImpressionCode "Avant Impression" d'un champ dans un état.
trtBoutonDroitDoubleClicCode de double-clic sur le bouton droit.
trtBoutonDroitEnfoncéCode du bouton droit enfoncé.
trtBoutonDroitRelâchéCode du bouton droit relâché.
trtBoutonGaucheDoubleClicCode de double-clic sur le bouton gauche.
trtBoutonGaucheEnfoncéCode du bouton gauche enfoncé.
trtBoutonGaucheRelâchéCode du bouton gauche relâché.
trtBoutonMilieuDoubleClicCode du double-clic sur le bouton du milieu.
trtBoutonMilieuEnfoncéCode du bouton du milieu enfoncé.
trtBoutonMilieuRelâchéCode du bouton du milieu relâché.
trtBoutonSystèmeCode "Avant fermeture par bouton "OK/Fermer".
trtChangementAgencementCode "Changement d'agencement" d'une fenêtre.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtChangementPériodeAgendaCode "A chaque changement de période" d'un champ Agenda.
trtChangementPériodePlanningCode "A chaque changement de période" d'un champ Planning.
trtChangementPlanCode "A chaque changement de plan" d'un champ Bandeau défilant.
trtChangementPositionCarteCode "A chaque changement de position" d'un champ Carte.
trtChangementTailleWidgetCode "Changement de taille d'un Widget" d'un champ Tableau de bord.
trtChangeTailleCode de changement de taille de la fenêtre.
trtChargementDifféréPlanCode "Chargement différé d'un plan" d'un plan.
trtChargementRessourceHTMLCode "Chargement de ressources" d'un champ Editeur HTML ou d'un champ d'affichage HTML.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtClic
  • Code de clic du champ.
  • Code du bouton associé au clic dans la fenêtre.
Nouveauté 2024
trtClicBoutonSaisieDroite
Code "Clic sur le bouton droit du champ de saisie".
WEBDEV - Code Serveur Cette constante n'est pas disponible.
Nouveauté 2024
trtClicBoutonSaisieGauche
Code "Clic sur le bouton gauche du champ de saisie".
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtClicDroit
  • Code de clic droit (uniquement pour le champ Arbre).
  • Code du bouton associé au clic droit dans la fenêtre.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtClicDroitLienHTMLCode "Clic droit sur un lien" d'un champ d'affichage HTML.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtClicFlècheBoutonCode de clic sur la flèche associée à un bouton.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtClicJetonCode de clic sur un jeton présent dans un champ de saisie de type "Jetons de texte".
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtClicLienHTMLCode "Clic sur un lien" d'un champ d'affichage HTML.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtDébutDéplacementCarteKanbanCode de début de déplacement d'une carte dans un champ Kanban.
trtDéfilementHorizontalCode "Ascenseur horizontal" (champ Ascenseur uniquement).
trtDéfilementVerticalCode "Ascenseur vertical" (champ Ascenseur uniquement).
trtDemandeMiseAJourCode "Demande de mise à jour de l'affichage" (fenêtre et fenêtre interne).
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtDéplaceDiagFormeCode de déplacement d'une forme dans un champ Editeur de diagrammes.
trtDéplacementCarteKanbanCode de déplacement d'une carte dans un champ Kanban.
trtDéplacementFenêtreCode de déplacement de la fenêtre.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtDéplacementRdvAgendaCode de déplacement d'un rendez-vous dans un champ Agenda.
trtDéplacementRdvPlanningCode de déplacement d'un rendez-vous dans un champ Planning.
trtDéplacementWidgetCode "Déplacement d'un Widget" d'un champ Tableau de bord.
trtDétailCarteKanbanCode d'affichage du détail d'une carte dans un champ Kanban.
trtDoubleClic
  • Code de double clic.
  • Code du bouton associé au double clic dans la fenêtre.
trtEnrouleDérouleBrancheCode Enroulé / Déroulé d'un noeud d'un champ Arbre ou Table hiérarchique.
trtEnrouleDérouleRuptureCode Enroulé / Déroulé d'une rupture d'un champ Zone répétée ou Table.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtEntréeCode d'entrée dans le champ.
trtEntréeLigneCode d'entrée de ligne (champ Table uniquement).
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtEntréeSaisieRdvAgendaCode d'entrée en saisie d'un rendez-vous dans un champ Agenda.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtEntréeSaisieRdvPlanningCode d'entrée en saisie d'un rendez-vous dans un champ Planning.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtEntréeSurvolCode optionnel d'entrée en survol dans un champ Table.
trtFenEdChangeTailleCode exécuté lors du changement de taille d'un champ en mode "Edition par l'utilisateur". Ce traitement permet notamment de savoir la manipulation effectuée par l'utilisateur et d'exécuter un code spécifique.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtFenEdDéplacementCode exécuté lors du déplacement d'un champ en mode "Edition par l'utilisateur". Ce traitement permet notamment de savoir la manipulation effectuée par l'utilisateur et d'exécuter un code spécifique.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtFenEdSélectionCode exécuté lors de la sélection d'un champ en mode "Edition par l'utilisateur". Ce traitement permet notamment de savoir la manipulation effectuée par l'utilisateur et d'exécuter un code spécifique.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtFermeture
  • Code de fermeture de la fenêtre.
  • Code de fermeture de la page.
  • Code de fermeture de l'état.
trtFermetureComboCode de fermeture de la liste déroulante.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtFiltreCode de filtre des données de l'état.
trtFinDéplacementCarteKanbanCode de fin de déplacement d'une carte dans un champ Kanban.
trtFinInitialisationCode de fin d'initialisation (champ Liste, Table et Combo fichier).
trtFinModificationCode de fin de modification (champ Potentiomètre et Ascenseur uniquement).
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtInit
  • Code d'initialisation du champ.
  • Code d'initialisation de la fenêtre.
  • Code d'initialisation de la page.
  • Code d'ouverture de l'état.
trtLectureDernierCode de lecture du dernier enregistrement (champ Table uniquement).
trtLectureDonnéesCode de lecture des données de l'état.
trtLecturePrécédentCode de lecture de l'enregistrement précédent (champ Table uniquement).
trtLecturePremierCode de lecture du premier enregistrement (champ Table uniquement).
trtLectureSuivantCode de lecture de l'enregistrement suivant (champ Table uniquement).
trtMiseAJourUICode "Demande de mise à jour de l'affichage" (fenêtre et fenêtre interne).
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtModification
  • Code "A chaque modification du champ".
  • Code de modification de la fenêtre.
trtModificationCelluleTableurCode "Modification d'une cellule" d'un champ Tableur.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtModificationFiltreColonneCode "A chaque modification du filtre (saisie dans l'entête par l'utilisateur)" d'un champ Colonne de table.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtModificationPotentiomètreCode "A chaque modification" (champ Potentiomètre uniquement).
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtModificationZoomCode de modification de l'étendue (zoom) d'un champ Range Slider.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtModifieDiagFormeCode de modification d'une forme dans un champ Editeur de diagrammes.
trtOptionMenuCode d'une option de menu (principal ou contextuel).
trtOuverture
  • Code d'initialisation de la fenêtre.
  • Code d'ouverture de la page.
  • Code d'ouverture de l'état.
trtOuvertureComboCode d'ouverture de la liste déroulante du champ Combo.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtPerteFocusCode de perte de focus de la fenêtre.
trtPriseFocusCode de prise de focus de la fenêtre.
trtRéaffectationDeRessourceRdvPlanningCode de ré-affectation d'un rendez-vous dans un champ Planning.
trtRécupérationValeurCode de récupération de la propriété Valeur d'un champ Composant Web.
trtRedimensionneDiagFormeCode de redimensionnement d'une forme dans un champ Editeur de diagrammes.
trtRedimensionnementRdvAgendaCode de redimensionnement d'un rendez-vous dans un champ Agenda.
trtRedimensionnementRdvPlanningCode de redimensionnement d'un rendez-vous dans un champ Planning.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtRouletteSourisCode d'utilisation de la roulette de la souris.
trtSélectionCode de sélection (champ Combo, Liste et Table).
trtSélectionDiagFormeCode de sélection d'une forme dans un champ Editeur de diagrammes.
trtSélectionPériodeAgendaCode de sélection d'une période dans un champ Agenda.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtSélectionPériodePlanningCode de sélection d'une période dans un champ Planning.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtSélectionRdvAgendaCode de sélection d'un rendez-vous dans un champ Agenda.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtSélectionRdvPlanningCode de sélection d'un rendez-vous dans un champ Planning.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtSortieCode de sortie du champ.
trtSortieLigneCode de sortie de ligne (champ Table uniquement).
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtSortieSaisieRdvAgendaCode de sortie de saisie d'un rendez-vous dans un champ Agenda.
trtSortieSaisieRdvPlanningCode de sortie de saisie d'un rendez-vous dans un champ Planning.
trtSortieSurvolCode de sortie de survol du champ Table.
trtSpinMoinsCode de décrémentation d'un champ Spin.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtSpinPlusCode d'incrémentation d'un champ Spin.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtSuppressionCarteKanbanCode de suppression d'une carte dans un champ Kanban.
trtSuppressionJetonCode de suppression d'un jeton dans un champ de saisie de type "Jetons de texte".
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtSuppressionRdvAgendaCode de suppression d'un rendez-vous dans un champ Agenda.
trtSuppressionRdvPlanningCode de suppression d'un rendez-vous dans un champ Planning.
trtSuppressionWidgetCode de suppression d'un widget dans un champ Tableau de bord.
trtSupprimeDiagFormeCode de suppression d'une forme dans un champ Editeur de diagrammes.
trtSurvolCode Survol du champ.
trtTirerPourRafraîchirCode "Rafraîchissement par tirer/relâcher" dans un champ Table ou Zone répétée.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtToucheAppuyéeCode Touche appuyée.
trtToucheEnfoncéeCode Touche enfoncée.
trtToucheRelâchéeCode Touche relâchée.
trtToucheSystèmeAppuyéeCode Touche système appuyée.
trtToucheSystèmeEnfoncéeCode Touche système enfoncée.
trtToucheSystèmeRelâchéeCode Touche système relâchée.
<Procédure> : Nom de procédure WLangage
Nom de la procédure ou de la méthode WLangage à exécuter.
Attention: il faut juste indiquer le nom de la procédure (sans les parenthèses).
Remarques

Cas des événements optionnels

Si l'événement modifié par la propriété Traitement est un événement optionnel du champ (de la fenêtre ou de la page), cet événement est automatiquement créé : il n'est pas nécessaire d'avoir ajouté cet événement sous l'éditeur de code.

Cas des événements attendant des paramètres

Certains événements utilisent des paramètres (par exemple, événements concernant les champs Agenda ou Planning). La procédure définie avec la propriété Traitement ne doit pas attendre plus de paramètres que l'événement associé (elle peut par contre en attendre moins).

Utilisation du mot-clé MoiMême

Si le mot-clé MoiMême est utilisé dans une procédure appelée par la propriété Traitement, il correspondra au champ qui exécute la procédure.

Sortir de l'enchaînement des procédures

Si plusieurs procédures s'enchaînent, il est possible d'interrompre l'enchaînement des procédures à partir du code d'une des procédures en utilisant la fonction DonneFocusEtRetourUtilisateur.
Exemple :
// Clic sur BTN_Bouton1
BTN_Bouton1.Traitement[trtClic] += MaProc1
BTN_Bouton1.Traitement[trtClic] += MaProc2
// Clic sur BTN_Bouton1
Trace("Clic sur Bouton 1")
PROCÉDURE MaProc1()
Trace(dbgInfo(dbgTraitement))
DonneFocusEtRetourUtilisateur(MoiMême.Nom)
PROCÉDURE MaProc2()
Trace(dbgInfo(dbgTraitement))
Version minimum requise
  • Version 19
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 21/12/2023

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