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.
WINDEVUniversal Windows 10 AppJava Cette constante n'est pas disponible.
trtAffectationValeurCode d'affectation de la propriété Valeur d'un champ Composant Web.
WINDEVUniversal Windows 10 AppJava Cette constante n'est pas disponible.
trtAffichageLigneCode d'affichage de ligne (champ Table uniquement).

Universal Windows 10 App Cette constante n'est pas disponible.
trtAffichageMenuContextuelCode optionnel d'affichage du menu contextuel.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtAjoutCarteKanbanCode d'ajout d'une carte dans un champ Kanban.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtAjouteDiagFormeCode d'ajout d'une forme dans un champ Editeur de diagrammes.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtAjoutJetonCode d'ajout d'un jeton dans un champ de saisie de type "Jetons de texte".
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtAjoutWidgetCode d'ajout d'un Widget dans un champ Tableau de bord.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtAprèsChangeGabaritCode "Après changement de gabarit" d'une fenêtre interne.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtAprèsChargementPageHTMLCode "Après chargement de la page HTML" d'un champ d'affichage HTML.
Universal Windows 10 AppJava 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.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtAvantChangeGabaritCode "Avant changement de gabarit" d'une fenêtre interne.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtAvantChargementPageHTMLCode "Avant chargement de la page HTML" d'un champ d'affichage HTML.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtAvantCréationRdvAgendaCode "Avant création du rendez-vous" d'un champ Agenda.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtAvantCréationRdvPlanningCode "Avant création du rendez-vous" d'un champ Planning.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
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.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtAvantFermetureFenêtreCode "Autorisation de fermeture".
Java 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.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtChangementPériodeAgendaCode "A chaque changement de période" d'un champ Agenda.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtChangementPériodePlanningCode "A chaque changement de période" d'un champ Planning.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtChangementPlanCode "A chaque changement de plan" d'un champ Bandeau défilant.
WINDEVUniversal Windows 10 AppJava Cette constante n'est pas disponible.
trtChangementPositionCarteCode "A chaque changement de position" d'un champ Carte.
Java Cette constante n'est pas disponible.
trtChangementTailleWidgetCode "Changement de taille d'un Widget" d'un champ Tableau de bord.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtChangeTailleCode de changement de taille de la fenêtre.
Universal Windows 10 App Cette constante n'est pas disponible.
trtChargementDifféréPlanCode "Chargement différé d'un plan" d'un plan.
WINDEVUniversal Windows 10 AppJava Cette constante n'est pas disponible.
trtChargementRessourceHTMLCode "Chargement de ressources" d'un champ Editeur HTML ou d'un champ d'affichage HTML.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
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".
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtClicBoutonSaisieGaucheCode "Clic sur le bouton gauche du champ de saisie".
Universal Windows 10 AppJava 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.
Universal Windows 10 App Cette constante n'est pas disponible.
trtClicDroitLienHTMLCode "Clic droit sur un lien" d'un champ d'affichage HTML.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtClicFlècheBoutonCode de clic sur la flèche associée à un bouton.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtClicJetonCode de clic sur un jeton présent dans un champ de saisie de type "Jetons de texte".
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtClicLienHTMLCode "Clic sur un lien" d'un champ d'affichage HTML.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtDébutDéplacementCarteKanbanCode de début de déplacement d'une carte dans un champ Kanban.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
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).
Java Cette constante n'est pas disponible.
trtDéplaceDiagFormeCode de déplacement d'une forme dans un champ Editeur de diagrammes.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtDéplacementCarteKanbanCode de déplacement d'une carte dans un champ Kanban.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtDéplacementFenêtreCode de déplacement de la fenêtre.
Java Cette constante n'est pas disponible.
trtDéplacementRdvAgendaCode de déplacement d'un rendez-vous dans un champ Agenda.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtDéplacementRdvPlanningCode de déplacement d'un rendez-vous dans un champ Planning.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtDéplacementWidgetCode "Déplacement d'un Widget" d'un champ Tableau de bord.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtDétailCarteKanbanCode d'affichage du détail d'une carte dans un champ Kanban.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtDoubleClic
  • Code de double clic.
  • Code du bouton associé au double clic dans la fenêtre.
Universal Windows 10 App Cette constante n'est pas disponible.
trtEnrouleDérouleBrancheCode Enroulé / Déroulé d'un noeud d'un champ Arbre ou Table hiérarchique.
Universal Windows 10 App Cette constante n'est pas disponible.
trtEnrouleDérouleRuptureCode Enroulé / Déroulé d'une rupture d'un champ Zone répétée ou Table.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtEntréeCode d'entrée dans le champ.
trtEntréeLigneCode d'entrée de ligne (champ Table uniquement).
Universal Windows 10 App Cette constante n'est pas disponible.
trtEntréeSaisieJetonCode d'entrée en saisie dans un jeton présent dans un champ de saisie de type "Jetons de texte".
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtEntréeSaisieRdvAgendaCode d'entrée en saisie d'un rendez-vous dans un champ Agenda.
Universal Windows 10 App Cette constante n'est pas disponible.
trtEntréeSaisieRdvPlanningCode d'entrée en saisie d'un rendez-vous dans un champ Planning.
Universal Windows 10 App Cette constante n'est pas disponible.
trtEntréeSurvolCode optionnel d'entrée en survol dans un champ Table.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
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.
Universal Windows 10 AppJava 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.
Universal Windows 10 AppJava 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.
Universal Windows 10 AppJava 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.
Universal Windows 10 App 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.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtFinInitialisationCode de fin d'initialisation (champ Liste, Table et Combo fichier).
trtFinModificationCode de fin de modification (champ Potentiomètre et Ascenseur uniquement).
Universal Windows 10 App 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).
Universal Windows 10 App Cette constante n'est pas disponible.
trtLectureDonnéesCode de lecture des données de l'état.
trtLecturePrécédentCode de lecture de l'enregistrement précédent (champ Table uniquement).
Universal Windows 10 App Cette constante n'est pas disponible.
trtLecturePremierCode de lecture du premier enregistrement (champ Table uniquement).
Universal Windows 10 App Cette constante n'est pas disponible.
trtLectureSuivantCode de lecture de l'enregistrement suivant (champ Table uniquement).
Universal Windows 10 App Cette constante n'est pas disponible.
trtMiseAJourUICode "Demande de mise à jour de l'affichage" (fenêtre et fenêtre interne).
Java 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.
Universal Windows 10 AppJava 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.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtModificationJetonCode de modification du texte d'un jeton présent dans un champ de saisie de type "Jetons de texte".
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtModificationPotentiomètreCode "A chaque modification" (champ Potentiomètre uniquement).
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtModificationZoomCode de modification de l'étendue (zoom) d'un champ Range Slider.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtModifieDiagFormeCode de modification d'une forme dans un champ Editeur de diagrammes.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
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.
Universal Windows 10 App Cette constante n'est pas disponible.
trtPriseFocusCode de prise de focus de la fenêtre.
Universal Windows 10 App Cette constante n'est pas disponible.
trtRéaffectationDeRessourceRdvPlanningCode de ré-affectation d'un rendez-vous dans un champ Planning.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtRécupérationValeurCode de récupération de la propriété Valeur d'un champ Composant Web.
WINDEVUniversal Windows 10 AppJava Cette constante n'est pas disponible.
trtRedimensionneDiagFormeCode de redimensionnement d'une forme dans un champ Editeur de diagrammes.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtRedimensionnementRdvAgendaCode de redimensionnement d'un rendez-vous dans un champ Agenda.
Universal Windows 10 App Cette constante n'est pas disponible.
trtRedimensionnementRdvPlanningCode de redimensionnement d'un rendez-vous dans un champ Planning.
Universal Windows 10 App 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.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtSélectionPériodeAgendaCode de sélection d'une période dans un champ Agenda.
Universal Windows 10 App Cette constante n'est pas disponible.
trtSélectionPériodePlanningCode de sélection d'une période dans un champ Planning.
Universal Windows 10 App Cette constante n'est pas disponible.
trtSélectionRdvAgendaCode de sélection d'un rendez-vous dans un champ Agenda.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtSélectionRdvPlanningCode de sélection d'un rendez-vous dans un champ Planning.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtSortieCode de sortie du champ.
trtSortieLigneCode de sortie de ligne (champ Table uniquement).
Universal Windows 10 App Cette constante n'est pas disponible.
trtSortieSaisieRdvAgendaCode de sortie de saisie d'un rendez-vous dans un champ Agenda.
Universal Windows 10 App Cette constante n'est pas disponible.
trtSortieSaisieRdvPlanningCode de sortie de saisie d'un rendez-vous dans un champ Planning.
Universal Windows 10 App Cette constante n'est pas disponible.
trtSortieSurvolCode de sortie de survol du champ Table.
Universal Windows 10 App Cette constante n'est pas disponible.
trtSpinMoinsCode de décrémentation d'un champ Spin.
Universal Windows 10 App Cette constante n'est pas disponible.
trtSpinPlusCode d'incrémentation d'un champ Spin.
Universal Windows 10 App Cette constante n'est pas disponible.
trtSuppressionCarteKanbanCode de suppression d'une carte dans un champ Kanban.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtSuppressionJetonCode de suppression d'un jeton dans un champ de saisie de type "Jetons de texte".
Universal Windows 10 App Cette constante n'est pas disponible.
trtSuppressionRdvAgendaCode de suppression d'un rendez-vous dans un champ Agenda.
Universal Windows 10 App Cette constante n'est pas disponible.
trtSuppressionRdvPlanningCode de suppression d'un rendez-vous dans un champ Planning.
Universal Windows 10 App Cette constante n'est pas disponible.
trtSuppressionWidgetCode de suppression d'un widget dans un champ Tableau de bord.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtSupprimeDiagFormeCode de suppression d'une forme dans un champ Editeur de diagrammes.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtSurvolCode Survol du champ.
trtTirerPourRafraîchirCode "Rafraîchissement par tirer/relâcher" dans un champ Table ou Zone répétée.
Java 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.
Java Cette constante n'est pas disponible.
trtToucheSystèmeEnfoncéeCode Touche système enfoncée.
Java Cette constante n'est pas disponible.
trtToucheSystèmeRelâchéeCode Touche système relâchée.
Java Cette constante n'est pas disponible.
<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