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, etc.
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.
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".
trtAjoutWidgetCode d'ajout d'un Widget dans un champ Tableau de bord.
trtAprèsChangeGabaritCode "Après changement de gabarit" d'une fenêtre interne.
trtAprèsChargementPageHTMLCode "Après chargement de la page HTML" d'un champ d'affichage HTML.
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.
trtAvantChangeGabaritCode "Avant changement de gabarit" d'une fenêtre interne.
trtAvantChargementPageHTMLCode "Avant chargement de la page HTML" d'un champ d'affichage HTML.
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.
trtAvantFermetureFenêtreCode "Autorisation de fermeture".
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.
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.
trtClic
  • Code de clic du champ.
  • Code du bouton associé au clic dans la fenêtre.
trtClicBoutonSaisieDroiteCode "Clic sur le bouton droit du champ de saisie".
trtClicBoutonSaisieGaucheCode "Clic sur le bouton gauche du champ de saisie".
trtClicDroit
  • Code de clic droit (uniquement pour le champ Arbre).
  • Code du bouton associé au clic droit dans la fenêtre.
trtClicDroitLienHTMLCode "Clic droit sur un lien" d'un champ d'affichage HTML.
trtClicFlècheBoutonCode de clic sur la flèche associée à un bouton.
trtClicJetonCode de clic sur un jeton présent dans un champ de saisie de type "Jetons de texte".
trtClicLienHTMLCode "Clic sur un lien" d'un champ d'affichage HTML.
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).
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.
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.
trtEntréeCode d'entrée dans le champ.
trtEntréeLigneCode d'entrée de ligne (champ Table uniquement).
trtEntréeSaisieJetonCode d'entrée en saisie dans un jeton présent dans un champ de saisie de type "Jetons de texte".
trtEntréeSaisieRdvAgendaCode d'entrée en saisie d'un rendez-vous dans un champ Agenda.
trtEntréeSaisieRdvPlanningCode d'entrée en saisie d'un rendez-vous dans un champ Planning.
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.
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.
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.
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.
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).
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).
trtModification
  • Code "A chaque modification du champ".
  • Code de modification de la fenêtre.
trtModificationCelluleTableurCode "Modification d'une cellule" d'un champ Tableur.
trtModificationFiltreColonneCode "A chaque modification du filtre (saisie dans l'entête par l'utilisateur)" d'un champ Colonne de table.
trtModificationJetonCode de modification du texte d'un jeton présent dans un champ de saisie de type "Jetons de texte".
trtModificationPotentiomètreCode "A chaque modification" (champ Potentiomètre uniquement).
trtModificationZoomCode de modification de l'étendue (zoom) d'un champ Range Slider.
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.
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.
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.
trtSélectionPériodePlanningCode de sélection d'une période dans un champ Planning.
trtSélectionRdvAgendaCode de sélection d'un rendez-vous dans un champ Agenda.
trtSélectionRdvPlanningCode de sélection d'un rendez-vous dans un champ Planning.
trtSortieCode de sortie du champ.
trtSortieLigneCode de sortie de ligne (champ Table uniquement).
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.
trtSpinPlusCode d'incrémentation d'un champ Spin.
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".
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.
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 : 12/06/2024

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