DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion de Windows / Fonctions diverses WINDEV
  • 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 :
WEBDEV - Code ServeurWEBDEV - Code NavigateurPHP L'événement/traitement exécuté peut être uniquement un traitement d'un champ d'une page, d'une page ou d'une procédure. Appelée en code serveur, seul le code serveur de l'élément est exécuté. Appelée en code navigateur, le code navigateur et le code serveur de l'élément appelé est exécuté.
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.
trtAffectationValeurCode d'affectation de la propriété Valeur d'un champ Composant Web. Ce code est disponible en code navigateur uniquement.
trtAffichageLigneCode d'affichage de ligne (champ Table uniquement).
WEBDEV - Code Navigateur Cette constante n'est pas disponible.
trtAjoutCarteKanbanCode d'ajout d'une carte dans un champ Kanban.
trtAjouteDiagFormeCode d'ajout d'une forme dans un champ Editeur de diagrammes.
WEBDEV - Code Navigateur Cette constante n'est pas disponible.
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èsChargementPageHTMLCode "Après chargement de la page HTML" d'un champ d'affichage HTML.
WEBDEV - Code ServeurWEBDEV - Code Navigateur 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.
WEBDEV - Code ServeurWEBDEV - Code Navigateur Cette constante n'est pas disponible.
trtAvantChargementPageHTMLCode "Avant chargement de la page HTML" d'un champ d'affichage HTML.
WEBDEV - Code ServeurWEBDEV - Code Navigateur 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.
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.
WEBDEV - Code ServeurWEBDEV - Code Navigateur 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.
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.
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.
WEBDEV - Code ServeurWEBDEV - Code Navigateur Cette constante n'est pas disponible.
trtClicCode de clic du champ.
trtClicBoutonSaisieDroiteCode "Clic sur le bouton droit du champ de saisie".
WEBDEV - Code ServeurWEBDEV - Code Navigateur Cette constante n'est pas disponible.
trtClicBoutonSaisieGaucheCode "Clic sur le bouton gauche du champ de saisie".
WEBDEV - Code ServeurWEBDEV - Code Navigateur Cette constante n'est pas disponible.
trtClicDroitCode de clic droit (uniquement pour le champ Arbre).
WEBDEV - Code ServeurWEBDEV - Code Navigateur Cette constante n'est pas disponible.
trtClicDroitLienHTMLCode "Clic droit sur un lien" d'un champ d'affichage HTML.
WEBDEV - Code ServeurWEBDEV - Code Navigateur Cette constante n'est pas disponible.
trtClicFlècheBoutonCode de clic sur la flèche associée à un bouton.
WEBDEV - Code ServeurWEBDEV - Code Navigateur Cette constante n'est pas disponible.
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.
WEBDEV - Code ServeurWEBDEV - Code Navigateur Cette constante n'est pas disponible.
trtDébutDéplacementCarteKanbanCode de début de déplacement d'une carte dans un champ Kanban.
trtDéplaceDiagFormeCode de déplacement d'une forme dans un champ Editeur de diagrammes.
WEBDEV - Code Navigateur Cette constante n'est pas disponible.
trtDéplacementCarteKanbanCode de déplacement d'une carte dans un champ Kanban.
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.
trtDoubleClicCode de double clic.
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.
WEBDEV - Code ServeurWEBDEV - Code Navigateur Cette constante n'est pas disponible.
trtEnrouleDérouleRuptureCode Enroulé / Déroulé d'une rupture d'un champ Zone répétée ou Table.
WEBDEV - Code ServeurWEBDEV - Code Navigateur Cette constante n'est pas disponible.
trtEnrouleDérouleTiroirCode navigateur exécuté à chaque fois que le champ Tiroir est enroulé ou déroulé.
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 ServeurWEBDEV - Code Navigateur 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".
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.
trtFermetureComboCode de fermeture de la liste déroulante.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
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).
WEBDEV - Code Navigateur Cette constante n'est pas disponible.
trtFinModificationCode de fin de modification (champ Potentiomètre et Ascenseur uniquement).
WEBDEV - Code ServeurWEBDEV - Code Navigateur Cette constante n'est pas disponible.
trtInitCode d'initialisation du champ.
WEBDEV - Code Navigateur Cette constante n'est pas disponible.
trtLectureDernierCode de lecture du dernier enregistrement (champ Table uniquement)
WEBDEV - Code Navigateur Cette constante n'est pas disponible.
trtLecturePrécédentCode de lecture de l'enregistrement précédent (champ Table uniquement).
WEBDEV - Code Navigateur Cette constante n'est pas disponible.
trtLecturePremierCode de lecture du premier enregistrement (champ Table uniquement).
WEBDEV - Code Navigateur Cette constante n'est pas disponible.
trtLectureSuivantCode de lecture de l'enregistrement suivant (champ Table uniquement).
WEBDEV - Code Navigateur Cette constante n'est pas disponible.
trtModificationCode "A chaque modification du champ".
WEBDEV - Code Navigateur Cette constante n'est pas disponible.
trtModificationCelluleTableurCode "Modification d'une cellule" d'un champ Tableur.
WEBDEV - Code ServeurWEBDEV - Code Navigateur 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.
WEBDEV - Code ServeurWEBDEV - Code Navigateur Cette constante n'est pas disponible.
trtModificationJetonCode de modification du texte d'un un jeton présent dans un champ de saisie de type "Jetons de texte".
trtModificationPotentiomètreCode "A chaque modification" (champ Potentiomètre uniquement).
WEBDEV - Code ServeurWEBDEV - Code Navigateur Cette constante n'est pas disponible.
trtModificationZoomCode de modification de l'étendue (zoom) d'un champ Range Slider.
WEBDEV - Code ServeurWEBDEV - Code Navigateur Cette constante n'est pas disponible.
trtModifieDiagFormeCode de modification d'une forme dans un champ Editeur de diagrammes.
WEBDEV - Code Navigateur 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.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtRafraîchissementRubanCode de rafraîchissement du ruban des champs Lecteur PDF et Traitement de texte.
WEBDEV - Code ServeurWEBDEV - Code Navigateur Cette constante n'est pas disponible.
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. Ce code est disponible en code navigateur uniquement.
trtRedimensionneDiagFormeCode de redimensionnement d'une forme dans un champ Editeur de diagrammes.
WEBDEV - Code Navigateur Cette constante n'est pas disponible.
trtRedimensionnementRdvAgendaCode de redimensionnement d'un rendez-vous dans un champ Agenda.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtRedimensionnementRdvPlanningCode de redimensionnement d'un rendez-vous dans un champ Planning.
WEBDEV - Code Serveur Cette constante n'est pas disponible.
trtSélectionCode de sélection (champ Combo, Liste et Table).
WEBDEV - Code Navigateur Cette constante n'est pas disponible.
trtSélectionDiagFormeCode de sélection d'une forme dans un champ Editeur de diagrammes.
WEBDEV - Code Navigateur Cette constante n'est pas disponible.
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 ServeurWEBDEV - Code Navigateur 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.
trtSpinMoinsCode de décrémentation d'un champ Spin.
WEBDEV - Code ServeurWEBDEV - Code Navigateur Cette constante n'est pas disponible.
trtSpinPlusCode d'incrémentation d'un champ Spin.
WEBDEV - Code ServeurWEBDEV - Code Navigateur Cette constante n'est pas disponible.
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.
WEBDEV - Code Navigateur Cette constante n'est pas disponible.
trtTirerPourRafraîchirCode "Rafraichissement par tirer/relâcher" d'un champ Table ou Zone répétée.
WEBDEV - Code ServeurWEBDEV - Code Navigateur 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.
WEBDEV - Code NavigateurPHP Cette constante n'est pas disponible.
trtAvantImpressionCode "Avant Impression" d'un champ ou d'un bloc.
WEBDEV - Code NavigateurPHP 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).
WEBDEV - Code ServeurWEBDEV - Code NavigateurPHPAjax

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

ExécuteTraitement(<Page manipulée> , <Traitement> [, <Paramètre 1> [... [, <Paramètre N>]]])
<Page manipulée> : Nom de page
Nom de la page dont il faut exécuter un événement WLangage.
PHP Le nom de la page doit être entre guillemets.
<Traitement> : Constante de type entier
Evénement WLangage à exécuter parmi les événements WLangage disponibles pour les pages.
trtChangementAgencement
WEBDEV - Code Serveur Code "A chaque changement d'agencement" de la page.
trtChangementTranche
WEBDEV - Code Navigateur Code "A chaque changement de tranche" (page en mode Responsive Web Design).
trtChargement
WEBDEV - Code Navigateur Code de chargement de la page.
trtDéchargement
WEBDEV - Code Navigateur Code de déchargement de la page.
trtDéfilement
WEBDEV - Code Navigateur Code "Défilement" de la page.
trtDemandeMiseAJour
WEBDEV - Code Serveur Code "Demande de mise à jour de l'affichage".
trtFermeture
WEBDEV - Code Serveur Code de fermeture de la page.
PHP Cette constante est sans effet.
trtInit
WEBDEV - Code Serveur Code d'initialisation de la page.
trtOuverture
WEBDEV - Code Serveur Code d'ouverture de la page.
trtReset
WEBDEV - Code Navigateur Code de Reset de la page (formulaire initialisé).
trtSubmit
WEBDEV - Code Navigateur Code de submit de la page (formulaire envoyé).
<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).
WEBDEV - Code Serveur

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).
WEBDEV - Code ServeurPHPAjax

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.
WEBDEV - Code Serveur La procédure à exécuter est une procédure serveur.
<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
WEBDEV - Code ServeurAjax

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 : wd300vm.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 : 20/08/2024

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