DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Votre version : XXF220073H

Le contenu de cette page a été mis à jour en version 2024.  Consultez la documentation 2024 dès maintenant.
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 :
Nouveauté 22
trtAction
Code d'action d'un champ Composant Web.
Nouveauté 22
trtAffectationValeur
Code 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.
Versions 28 et supérieures
trtAjoutCarteKanban
Code d'ajout d'une carte dans un champ Kanban.
Versions 27 et supérieures
trtAjouteDiagForme
Code d'ajout d'une forme dans un champ Editeur de diagrammes.
Versions 24 et supérieures
trtAjoutJeton
Code 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.
Versions 26 et supérieures
trtAprèsChargementPageHTML
Code "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.
Versions 23 et supérieures
trtAprèsOuvertureDocument
Code "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.
Versions 26 et supérieures
trtAvantChargementPageHTML
Code "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.
Versions 23 et supérieures
trtAvantFermetureDocument
Code "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.
Versions 26 et supérieures
trtAvantFermetureFenêtre
Code "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".
Versions 23 et supérieures
trtChangementAgencement
Code "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.
Nouveauté 22
trtChangementPlan
Code "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.
Nouveauté 22
trtChargementDifféréPlan
Code "Chargement différé d'un plan" d'un plan.
Versions 26 et supérieures
trtChargementRessourceHTML
Code "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.
Versions 2024 et supérieures
trtClicBoutonSaisieDroite
Code "Clic sur le bouton droit du champ de saisie".
WEBDEV - Code Serveur Cette constante n'est pas disponible.
Versions 2024 et supérieures
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.
Versions 26 et supérieures
trtClicDroitLienHTML
Code "Clic droit sur un lien" d'un champ d'affichage HTML.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
Nouveauté 22
trtClicFlècheBouton
Code de clic sur la flèche associée à un bouton.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
Versions 24 et supérieures
trtClicJeton
Code 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.
Versions 26 et supérieures
trtClicLienHTML
Code "Clic sur un lien" d'un champ d'affichage HTML.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
Versions 28 et supérieures
trtDébutDéplacementCarteKanban
Code 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.
Versions 27 et supérieures
trtDéplaceDiagForme
Code de déplacement d'une forme dans un champ Editeur de diagrammes.
Versions 28 et supérieures
trtDéplacementCarteKanban
Code 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.
Versions 28 et supérieures
trtDétailCarteKanban
Code 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.
Nouveauté 22
trtEnrouleDérouleRupture
Code 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.
Versions 28 et supérieures
trtFinDéplacementCarteKanban
Code 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).
Nouveauté 22
trtMiseAJourIHM
Code "Demande de mise à jour de l'affichage" (fenêtre et fenêtre interne).
Remarque : Dans les versions précédentes, cette constante correspondait à trtMiseAJourIHM.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtModification
  • Code "A chaque modification du champ".
  • Code de modification de la fenêtre.
Nouveauté 22
trtModificationCelluleTableur
Code "Modification d'une cellule" d'un champ Tableur.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
Versions 24 et supérieures
trtModificationFiltreColonne
Code "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.
Versions 27 et supérieures
trtModifieDiagForme
Code 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.
Nouveauté 22
trtRécupérationValeur
Code de récupération de la propriété Valeur d'un champ Composant Web.
Versions 27 et supérieures
trtRedimensionneDiagForme
Code 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).
Versions 27 et supérieures
trtSélectionDiagForme
Code 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.
Versions 28 et supérieures
trtSuppressionCarteKanban
Code 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.
Versions 27 et supérieures
trtSupprimeDiagForme
Code 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