DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion de Windows / Fonctions diverses WINDEV
  • Exécution de l'événement "Enroulé/Déroulé"
  • Appeler une procédure globale de composant
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
ExécuteTraitement (Fonction)
En anglais : ExecuteProcess
Lance l'exécution d'un événement ou traitement par programmation, c'est-à-dire sans que l'utilisateur n'ait à effectuer une manipulation particulière dans l'interface. L'événement/traitement exécuté peut être :
  • un événement d'un champ (d'une fenêtre, d'une page ou d'un état),
  • un événement d'une option de menu,
  • un événement d'un bloc d'état,
  • un événement d'une fenêtre,
  • un événement d'une page,
  • un événement d'un état,
  • un traitement d'une procédure.
    Remarque : Pour déclencher l'exécution d'une procédure par le thread principal de l'application, utilisez :
Java L'événement/traitement exécuté peut être uniquement un traitement d'un champ d'une fenêtre, d'une option de menu, d'une fenêtre ou d'une procédure.
Exemple
// Exécute le traitement de clic sur un champ Bouton
ExécuteTraitement(BTN_Sauve, trtClic)
 
// Exécute le traitement de clic sur un champ via indirection
ExécuteTraitement({NChamp}..Valeur, trtClic)
// Exécute une procédure locale (test) appartenant
// à une autre fenêtre/page ouverte (menu)
ExécuteTraitement(Menu.Test, trtProcédure)
// Exécute la procédure LitFichier
// en lui passant en paramètre le nom du fichier
ExécuteTraitement(LitFichier, trtProcédure, NomFichier)
Syntaxe

Exécuter un événement associé à un champ Masquer les détails

ExécuteTraitement(<Champ manipulé> , <Traitement> [, <Paramètre 1> [... [, <Paramètre N>]]])
<Champ manipulé> : Nom de champ
Nom du champ (ou de l'option de menu) auquel est associé le traitement (ou l'événement) à exécuter.
Pour une option de menu contextuel, utilisez la notation <Nom du menu contextuel>.<Nom de l'option>.
Attention : Si le nom du champ n'est pas directement spécifié (usage d'une indirection par exemple), il est nécessaire d'utiliser explicitement la propriété Valeur.
<Traitement> : Constante de type entier
Evénement à exécuter parmi les événements WLangage disponibles des champs :
trtActionCode d'action d'un champ Composant Web. Ce code est disponible en code serveur et en code navigateur.
WINDEVUniversal Windows 10 AppJava Cette constante n'est pas disponible.
trtAffectationValeurCode d'affectation de la propriété Valeur d'un champ Composant Web. Ce code est disponible en code navigateur uniquement.
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.
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èsChargementPageHTMLCode "Après chargement de la page HTML" d'un champ d'affichage HTML.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
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.
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.
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.
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.
trtClicCode de clic du champ.
Nouveauté 2024
trtClicBoutonSaisieDroite
Code "Clic sur le bouton droit du champ de saisie".
Universal Windows 10 AppJava Cette constante n'est pas disponible.
Nouveauté 2024
trtClicBoutonSaisieGauche
Code "Clic sur le bouton gauche du champ de saisie".
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtClicDroitCode de clic droit (uniquement pour le champ Arbre).
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".
Java 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é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é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.
trtDoubleClicCode de double clic.
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.
Attention : Ce paramètre nécessite une syntaxe particulière. Pour plus de détails, consultez les remarques.
Universal Windows 10 AppJava 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.
trtEnrouleDérouleTiroirCode navigateur exécuté à chaque fois que le champ Tiroir est enroulé ou déroulé.
WINDEVUniversal 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 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 AppJava Cette constante n'est pas disponible.
trtEntréeSaisieRdvPlanningCode d'entrée en saisie d'un rendez-vous dans un champ Planning.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtFermetureComboCode de fermeture de la liste déroulante.
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.
trtInitCode d'initialisation du champ.
trtLectureDernierCode de lecture du dernier enregistrement (champ Table uniquement)
Universal Windows 10 App Cette constante n'est pas disponible.
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.
trtModificationCode "A chaque modification du champ".
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.
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).
trtOuvertureComboCode d'ouverture de la liste déroulante du champ Combo.
trtRafraîchissementRubanCode de rafraîchissement du ruban des champs Lecteur PDF et Traitement de texte.
Java 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. Ce code est disponible en code navigateur uniquement.
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 AppJava Cette constante n'est pas disponible.
trtRedimensionnementRdvPlanningCode de redimensionnement d'un rendez-vous dans un champ Planning.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
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 AppJava Cette constante n'est pas disponible.
trtSélectionPériodePlanningCode de sélection d'une période dans un champ Planning.
Universal Windows 10 AppJava 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 AppJava Cette constante n'est pas disponible.
trtSortieSaisieRdvPlanningCode de sortie de saisie d'un rendez-vous dans un champ Planning.
Universal Windows 10 AppJava 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 AppJava Cette constante n'est pas disponible.
trtSuppressionRdvAgendaCode de suppression d'un rendez-vous dans un champ Agenda.
Universal Windows 10 AppJava Cette constante n'est pas disponible.
trtSuppressionRdvPlanningCode de suppression d'un rendez-vous dans un champ Planning.
Universal Windows 10 AppJava 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.
trtTirerPourRafraîchirCode "Rafraichissement par tirer/relâcher" d'un champ Table ou Zone répétée.
Java Cette constante n'est pas disponible.


Champ ou bloc d'un état : Evénement à exécuter parmi les événements WLangage disponibles :
trtAprèsImpressionCode "Après Impression" d'un bloc.
trtAvantImpressionCode "Avant Impression" d'un champ ou d'un bloc.
<Paramètre 1> : Type quelconque optionnel
Premier paramètre optionnel à passer au code (cas des événements WLangage attendant des paramètres).
<Paramètre N> : Type quelconque optionnel
Nème paramètre optionnel à passer au code (cas des événements WLangage attendant des paramètres).
WINDEVUniversal Windows 10 AppJavaCode Utilisateur (MCU)

Exécuter un événement WLangage associé à une fenêtre Masquer les détails

ExécuteTraitement(<Fenêtre manipulée> , <Traitement> [, <Paramètre 1> [... [, <Paramètre N>]]])
<Fenêtre manipulée> : Nom de fenêtre
Nom de la fenêtre dont il faut exécuter un événement WLangage.
<Traitement> : Constante de type entier
Evénement à exécuter parmi les événements WLangage disponibles pour les fenêtres.
trtAvantFermetureFenêtreCode "Autorisation de fermeture".
Java Cette constante n'est pas disponible.
trtBoutonSystèmeCode "Avant fermeture par bouton "OK/Fermer".
trtChangementAgencementCode "Changement d'agencement".
Universal Windows 10 App 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.
trtClicCode du bouton associé au clic dans la fenêtre.
trtClicDroitCode du bouton associé au clic droit dans la fenêtre.
Universal Windows 10 App Cette constante n'est pas disponible.
trtDemandeMiseAJourCode "Demande de mise à jour de l'affichage".
trtDoubleClicCode du bouton associé au double clic dans la fenêtre.
Universal Windows 10 App Cette constante n'est pas disponible.
trtFermetureCode de fermeture de la fenêtre.
trtModificationCode de modification de la fenêtre.
trtOuverture ou trtInitCode d'initialisation de la fenêtre.
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.
<Paramètre 1> : Type quelconque optionnel
Premier paramètre optionnel à passer au code (cas des événements WLangage attendant des paramètres).
<Paramètre N> : Type quelconque optionnel
Nème paramètre optionnel à passer au code (cas des événements WLangage attendant des paramètres).
WINDEVCode Utilisateur (MCU)

Exécuter un événement WLangage associé à un état Masquer les détails

ExécuteTraitement(<Etat manipulé> , <Traitement> [, <Paramètre 1> [... [, <Paramètre N>]]])
<Etat manipulé> : Nom d'état
Nom de l'état dont il faut exécuter un traitement.
<Traitement> : Constante de type entier
evénement à exécuter parmi les événements WLangage disponibles pour les états.
trtFermetureCode de fermeture de l'état.
trtFiltreCode de filtre des données de l'état.
trtLectureDonnéesCode de lecture des données de l'état.
trtOuverture ou trtInitCode d'ouverture de l'état.
<Paramètre 1> : Type quelconque optionnel
Premier paramètre optionnel à passer au code (cas des événements WLangage attendant des paramètres).
<Paramètre N> : Type quelconque optionnel
Nème paramètre optionnel à passer au code (cas des événements WLangage attendant des paramètres).
WINDEVUniversal Windows 10 AppJavaCode Utilisateur (MCU)

Exécuter une procédure WLangage Masquer les détails

<Résultat> = ExécuteTraitement(<Procédure WLangage> , <Traitement> [, <Paramètre 1> [... [, <Paramètre N>]]])
<Résultat> : Quelconque
Valeur de retour de la procédure appelée. Cette valeur est identique à la valeur obtenue si la procédure est directement lancée.
<Procédure WLangage> : Nom de procédure
Nom de la procédure à exécuter.
<Traitement> : Constante de type entier
Procédure à exécuter. Cette procédure correspond :
  • soit à une des constantes suivantes :
    trtProcédureExécute la procédure désignée en fonction du contexte d'exécution (procédure de la fenêtre, procédure du composant WINDEV /WEBDEV ou du projet).
    trtProcédureProjetExécute la procédure désignée. Cette procédure est une procédure du projet accueillant le composant WINDEV/WEBDEV.
    Ce paramètre peut être utilisé uniquement pour un composant WINDEV/WEBDEV intégré dans un autre projet.
  • soit à une variable de type Description de procédure (utilisable uniquement pour exécuter une méthode de classe). Pour plus de détails, consulter Enumérer et manipuler les objets d'une classe.
<Paramètre 1> : Type quelconque optionnel
Premier paramètre optionnel à passer à la procédure.
<Paramètre N> : Type quelconque optionnel
Nème paramètre optionnel à passer à la procédure.
Remarques
WINDEVCode Utilisateur (MCU)

Exécution de l'événement "Enroulé/Déroulé"


Cas d'un champ Arbre
L'événement WLangage "Enroulé / Déroulé" d'un champ Arbre, disponible sous l'éditeur de code, attend les deux paramètres suivants :
  • <Chemin de l'élément> : Variable de type Texte, contenant le chemin complet de l'élément actuellement enroulé ou déroulé. Il suffit d'indiquer un nom de variable, cette variable sera automatiquement initialisée à l'exécution.
  • <Enroulé> : Variable de type Booléen, permettant de savoir quelle est l'action réalisée par l'utilisateur (enroule = Vrai ou déroule = Faux ). Il suffit d'indiquer un nom de variable, cette variable sera automatiquement initialisée à l'exécution.
Lors de l'exécution de cet événement grâce à la fonction ExécuteTraitement, il est également nécessaire d'indiquer ces deux paramètres. Dans ce cas, la syntaxe à utiliser est la suivante :
ExécuteTraitement(<Champ Arbre>, trtEnrouleDérouleBranche, <Chemin de l'élément>, <Enroulé>)
Pour plus de détails sur le code "Enroulé / Déroulé" d'un champ Arbre, consultez Evénements WLangage associés à un champ Arbre.
Cas d'un champ Table hiérarchique
L'événement WLangage "Enroulé / Déroulé" d'un champ Table hiérarchique sous l'éditeur de code n'attend aucun paramètre.
Lors de l'exécution de cet événement grâce à la fonction ExécuteTraitement, la syntaxe à utiliser est la suivante :
ExécuteTraitement(<Champ Table hiérarchique>, trtEnrouleDérouleBranche)
WINDEVCode Utilisateur (MCU)

Appeler une procédure globale de composant

La fonction ExécuteTraitement permet d'appeler une procédure globale de composant. Il suffit d'utiliser la syntaxe suivante :
ExécuteTraitement(<Composant>.<Collection de procédures>.<Procédure>, ...
trtProcédure)
Exemple :
ExécuteTraitement("MonComposant.Collection_WDExemple.MaProcédure", trtProcédure)
Dans un thread lancé par un composant il n'est pas possible d'appeler une procédure locale d'une fenêtre du projet hôte par ExécuteTraitement.
Il est nécessaire d'utiliser un procédure globale du projet hôte qui rappelle la procédure locale de la fenêtre.
Classification Métier / UI : Code neutre
Composante : wd290vm.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Ajouter une procédure à un traitement
On peut ajouter de façon simple une procédure à un traitement de champ ou de fenêtre avec cette syntaxe "+=" : le traitement ainsi modifié verra la procédure décrite s'exécuter immédiatement après le code du traitement. Cette procédure peut être globale à l'objet ou à la fenêtre ou même au projet.

Par exemple, pour mettre le fond d'un objet en vert lors de la saisie et de nouveau en blanc après la saisie :

MoiMême.Traitement[trtEntrée] += en_vert
MoiMême.Traitement[trtSortie] += en_blanc


PROCÉDURE en_vert()
MoiMême..CouleurFond=VertPastel

PROCÉDURE en_blanc()
MoiMême..CouleurFond=blanc

Merci à Thierry Tilier & à Jopab pour cette excellente idée.
bernard SOBRA
22 mar. 2023
Dynamically Execute Class Methods using ExecuteProcess()
Hi

Undocumented in the above help:
In order to dynamically call class methods use the following syntax.
ClassInst is ClassObject
MethodToCall is string = "ClassMethod"
ReturnVal is string (e.g. if the method returns a string value)

ReturnVal = ExecuteProcess(ClassInst,MethodToCall,Param1,Param2, ...)
PeHoBe
28 oct. 2021

Dernière modification : 21/12/2023

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