ExécuteTraitement (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion de Windows / Fonctions diverses WINDEV

Appeler une procédure globale de composant

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

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 :
- la fonction ExécuteThreadPrincipal.
- la fonction ExécuteThreadPrincipalAsynchrone.

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 :
trtAction Code d'action d'un champ Composant Web. Ce code est disponible en code serveur et en code navigateur.
trtAffectationValeur Code d'affectation de la propriété Valeur d'un champ Composant Web. Ce code est disponible en code navigateur uniquement.
trtAffichageLigne Code d'affichage de ligne (champ Table uniquement).
trtAjoutCarteKanban Code d'ajout d'une carte dans un champ Kanban.
trtAjouteDiagForme Code d'ajout d'une forme dans un champ Editeur de diagrammes.
trtAjoutJeton Code d'ajout d'un jeton dans un champ de saisie de type "Jetons de texte".
trtAjoutWidget Code d'ajout d'un Widget dans un champ Tableau de bord.
trtAprèsChargementPageHTML Code "Après chargement de la page HTML" d'un champ d'affichage HTML.
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.
trtAvantChargementPageHTML Code "Avant chargement de la page HTML" d'un champ d'affichage HTML.
trtAvantCréationRdvAgenda Code "Avant création du rendez-vous" d'un champ Agenda.
trtAvantCréationRdvPlanning Code "Avant création du rendez-vous" d'un champ Planning.
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.
trtChangementPériodeAgenda Code "A chaque changement de période" d'un champ Agenda.
trtChangementPériodePlanning Code "A chaque changement de période" d'un champ Planning.
trtChangementPlan Code "A chaque changement de plan" d'un champ Bandeau défilant.
trtChangementPositionCarte Code "A chaque changement de position" d'un champ Carte.
trtChangementTailleWidget Code "Changement de taille d'un Widget" d'un champ Tableau de bord.
trtChargementDifféréPlan Code "Chargement différé d'un plan" d'un plan.
trtChargementRessourceHTML Code "Chargement de ressources" d'un champ Editeur HTML ou d'un champ d'affichage HTML.
trtClic Code de clic du champ.
Nouveauté 2024
trtClicBoutonSaisieDroite
Code "Clic sur le bouton droit du champ de saisie".
Nouveauté 2024
trtClicBoutonSaisieGauche
Code "Clic sur le bouton gauche du champ de saisie".
trtClicDroit Code de clic droit (uniquement pour le champ Arbre).
trtClicDroitLienHTML Code "Clic droit sur un lien" d'un champ d'affichage HTML.
trtClicFlècheBouton Code de clic sur la flèche associée à un bouton.
trtClicJeton Code de clic sur un jeton présent dans un champ de saisie de type "Jetons de texte".
trtClicLienHTML Code "Clic sur un lien" d'un champ d'affichage HTML.
trtDébutDéplacementCarteKanban Code de début de déplacement d'une carte dans un champ Kanban.
trtDéplaceDiagForme Code de déplacement d'une forme dans un champ Editeur de diagrammes.
trtDéplacementCarteKanban Code de déplacement d'une carte dans un champ Kanban.
trtDéplacementRdvAgenda Code de déplacement d'un rendez-vous dans un champ Agenda.
trtDéplacementRdvPlanning Code de déplacement d'un rendez-vous dans un champ Planning.
trtDéplacementWidget Code "Déplacement d'un Widget" d'un champ Tableau de bord.
trtDétailCarteKanban Code d'affichage du détail d'une carte dans un champ Kanban.
trtDoubleClic Code de double clic.
trtEnrouleDérouleBranche Code 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.
trtEnrouleDérouleRupture Code Enroulé / Déroulé d'une rupture d'un champ Zone répétée ou Table.
trtEnrouleDérouleTiroir Code navigateur exécuté à chaque fois que le champ Tiroir est enroulé ou déroulé.
trtEntrée Code d'entrée dans le champ.
trtEntréeLigne Code d'entrée de ligne (champ Table uniquement).
trtEntréeSaisieRdvAgenda Code d'entrée en saisie d'un rendez-vous dans un champ Agenda.
trtEntréeSaisieRdvPlanning Code d'entrée en saisie d'un rendez-vous dans un champ Planning.
trtFermetureCombo Code de fermeture de la liste déroulante.
trtFinDéplacementCarteKanban Code de fin de déplacement d'une carte dans un champ Kanban.
trtFinInitialisation Code de fin d'initialisation (champ Liste, Table et Combo fichier).
trtFinModification Code de fin de modification (champ Potentiomètre et Ascenseur uniquement).
trtInit Code d'initialisation du champ.
trtLectureDernier Code de lecture du dernier enregistrement (champ Table uniquement)
trtLecturePrécédent Code de lecture de l'enregistrement précédent (champ Table uniquement).
trtLecturePremier Code de lecture du premier enregistrement (champ Table uniquement).
trtLectureSuivant Code de lecture de l'enregistrement suivant (champ Table uniquement).
trtModification Code "A chaque modification du champ".
trtModificationCelluleTableur Code "Modification d'une cellule" d'un champ Tableur.
trtModificationFiltreColonne Code "A chaque modification du filtre (saisie dans l'entête par l'utilisateur)" d'un champ Colonne de table.
trtModificationPotentiomètre Code "A chaque modification" (champ Potentiomètre uniquement).
trtModificationZoom Code de modification de l'étendue (zoom) d'un champ Range Slider.
trtModifieDiagForme Code de modification d'une forme dans un champ Editeur de diagrammes.
trtOptionMenu Code d'une option de menu (principal ou contextuel).
trtOuvertureCombo Code d'ouverture de la liste déroulante du champ Combo.
trtRafraîchissementRuban Code de rafraîchissement du ruban des champs Lecteur PDF et Traitement de texte.
trtRéaffectationDeRessourceRdvPlanning Code de ré-affectation d'un rendez-vous dans un champ Planning.
trtRécupérationValeur Code de récupération de la propriété Valeur d'un champ Composant Web. Ce code est disponible en code navigateur uniquement.
trtRedimensionneDiagForme Code de redimensionnement d'une forme dans un champ Editeur de diagrammes.
trtRedimensionnementRdvAgenda Code de redimensionnement d'un rendez-vous dans un champ Agenda.
trtRedimensionnementRdvPlanning Code de redimensionnement d'un rendez-vous dans un champ Planning.
trtSélection Code de sélection (champ Combo, Liste et Table).
trtSélectionDiagForme Code de sélection d'une forme dans un champ Editeur de diagrammes.
trtSélectionPériodeAgenda Code de sélection d'une période dans un champ Agenda.
trtSélectionPériodePlanning Code de sélection d'une période dans un champ Planning.
trtSélectionRdvAgenda Code de sélection d'un rendez-vous dans un champ Agenda.
trtSélectionRdvPlanning Code de sélection d'un rendez-vous dans un champ Planning.
trtSortie Code de sortie du champ.
trtSortieLigne Code de sortie de ligne (champ Table uniquement).
trtSortieSaisieRdvAgenda Code de sortie de saisie d'un rendez-vous dans un champ Agenda.
trtSortieSaisieRdvPlanning Code de sortie de saisie d'un rendez-vous dans un champ Planning.
trtSpinMoins Code de décrémentation d'un champ Spin.
trtSpinPlus Code d'incrémentation d'un champ Spin.
trtSuppressionCarteKanban Code de suppression d'une carte dans un champ Kanban.
trtSuppressionJeton Code de suppression d'un jeton dans un champ de saisie de type "Jetons de texte".
trtSuppressionRdvAgenda Code de suppression d'un rendez-vous dans un champ Agenda.
trtSuppressionRdvPlanning Code de suppression d'un rendez-vous dans un champ Planning.
trtSuppressionWidget Code de suppression d'un widget dans un champ Tableau de bord.
trtSupprimeDiagForme Code de suppression d'une forme dans un champ Editeur de diagrammes.
trtTirerPourRafraîchir Code "Rafraichissement par tirer/relâcher" d'un champ Table ou Zone répétée.

Champ ou bloc d'un état : Evénement à exécuter parmi les événements WLangage disponibles :
trtAprèsImpression Code "Après Impression" d'un bloc.
trtAvantImpression Code "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).

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être Code "Autorisation de fermeture".
trtBoutonSystème Code "Avant fermeture par bouton "OK/Fermer".
trtChangementAgencement Code "Changement d'agencement".
trtChangeTaille Code de changement de taille de la fenêtre.
trtClic Code du bouton associé au clic dans la fenêtre.
trtClicDroit Code du bouton associé au clic droit dans la fenêtre.
trtDemandeMiseAJour Code "Demande de mise à jour de l'affichage".
trtDoubleClic Code du bouton associé au double clic dans la fenêtre.
trtFermeture Code de fermeture de la fenêtre.
trtModification Code de modification de la fenêtre.
trtOuverture ou trtInit Code d'initialisation de la fenêtre.
trtPerteFocus Code de perte de focus de la fenêtre.
trtPriseFocus Code de prise de focus de la fenêtre.

<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).

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.
trtFermeture Code de fermeture de l'état.
trtFiltre Code de filtre des données de l'état.
trtLectureDonnées Code de lecture des données de l'état.
trtOuverture ou trtInit Code 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).

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édure Exé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édureProjet Exé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

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

Voir Aussi

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