Exécute (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

Exécuter l'événement associé à un champ ou une procédure d'une fenêtre (ou d'une page) différente de la fenêtre (ou de la page) en cours
Chaîne passée en paramètre à la fonction Exécute
Les tableaux
Ouverture de la fenêtre/page
Appeler une procédure globale de composant
Utilisation de fonctions spécifiques
Exécution de l'événement associé à un champ

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

Exécute (Fonction)

En anglais : Execute

Lance l'exécution d'un traitement par programmation. Cette fonction est utilisée principalement pour exécuter les procédures.

Par compatibilité, le traitement exécuté peut également être un traitement d'un champ, d'une fenêtre ou d'une page. Dans ces différents cas, il est conseillé d'utiliser ExécuteTraitement.

Le traitement exécuté correspond à un traitement serveur.

Le traitement exécuté correspond à un traitement navigateur.

Exemple

// Exécution d'une procédure
Exécute("Proced1")

// -- Clic sur le bouton BTN_BOUTON1
// Exécution d'une procédure retournant un résultat
Info(Exécute("Doubler_Nombre", 2)) // Affiche 4

// Procédure Doubler_Nombre
PROCÉDURE Doubler_Nombre(X)
RENVOYER 2*X

Syntaxe

Exécuter une procédure pouvant retourner un résultat Masquer les détails

<Résultat> = Exécute(<Procédure WLangage> [, <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 WLangage à exécuter. Cette procédure retourne un résultat.

<Paramètre 1> : Type quelconque optionnel

Premier paramètre optionnel à passer à la procédure. Ces paramètres sont toujours passés par valeur.

<Paramètre N> : Type quelconque optionnel

Nème paramètre optionnel à passer à la procédure. Ces paramètres sont toujours passés par valeur.

Exécuter le traitement d'un champ (syntaxe conservée pour compatibilité) Masquer les détails

Exécute(<Nom du champ> , <Traitement>)

<Nom du champ> : Chaîne de caractères

Nom du champ auquel est associé le traitement à exécuter.

<Traitement> : Chaîne de caractères

Traitement à exécuter :
Clic Code de clic d'un champ (ou d'une option de menu)
Sortie Code de sortie du champ
Cette constante n'est pas disponible.
Entrée Code d'entrée du champ
Cette constante n'est pas disponible.
Initialisation Code d'initialisation du champ
Cette constante n'est pas disponible.
Précédent Code de lecture de l'enregistrement précédent (table fichier en parcours programmé uniquement)
Code de lecture de l'enregistrement précédent (table fichier uniquement).

Cette constante n'est pas disponible.
Suivant Code de lecture de l'enregistrement suivant (table fichier en parcours programmé uniquement)
Code de lecture de l'enregistrement suivant (table fichier uniquement).

Cette constante n'est pas disponible.
Affiche Code d'affichage de ligne (table uniquement)
Cette constante n'est pas disponible.
LSortie Code de sortie d'une ligne de table
Cette constante n'est pas disponible.
LEntree Code d'entrée dans une ligne de table
Cette constante n'est pas disponible.
FIN Code de lecture du dernier enregistrement (table uniquement)
Cette constante n'est pas disponible.
Modifie Code A chaque modification du champ
Cette constante n'est pas disponible.
DBL Code de double-clic sur un élément d'un arbre
Double-clic (OnDblClick)
Cette constante n'est pas disponible.
CLD Code de clic droit sur un élément d'un arbre
Cette constante n'est pas disponible.
CLI Clic (OnClick) (code navigateur)
Cette constante n'est pas disponible.
KDN Touche enfoncée (OnKeyDown) (code navigateur)
Cette constante n'est pas disponible.
KPR Touche enfoncée et relâchée (OnKeyPressed) (code navigateur)
Cette constante n'est pas disponible.
KUP Touche relâchée (OnKeyUp) (code navigateur)
Cette constante n'est pas disponible.
MDN Bouton de la souris enfoncé (OnMouseDown) (code navigateur)
Cette constante n'est pas disponible.
MMV Souris bouge au-dessus du champ (OnMouseMove) (code navigateur)
Cette constante n'est pas disponible.
MOU Souris sort du champ (OnMouseOut) (code navigateur)
Cette constante n'est pas disponible.
MOV Souris entre sur le champ (OnMouseOver) (code navigateur)
Cette constante n'est pas disponible.
MUP Bouton de la souris relâché (OnMouseUp) (code navigateur)
Cette constante n'est pas disponible.
BLU Perte de focus (OnBlur) (code navigateur)
Cette constante n'est pas disponible.
CHG Modification (OnChange) (code navigateur)
Cette constante n'est pas disponible.
FOC Prise de focus (OnFocus) (code navigateur)
Cette constante n'est pas disponible.
SEL Texte sélectionné (OnSelect) (code navigateur)
Cette constante n'est pas disponible.
HLP Touche F1 (OnHelp) (code navigateur)
Cette constante n'est pas disponible.

Exécuter le traitement d'une fenêtre (syntaxe conservée par compatibilité) Masquer les détails

Exécute([<Nom de la fenêtre>, ] <Type de traitement>)

<Nom de la fenêtre> : Chaîne de caractères optionnelle

Nom de la fenêtre dont il faut exécuter un traitement. Si ce nom n'est pas spécifié, le traitement de la fenêtre en cours est lancé.

<Type de traitement> : Chaîne de caractères

Traitement à exécuter :
INF Ouverture de la fenêtre
FEF Fermeture de la fenêtre
PRF Prise de focus de la fenêtre
PEF Perte de focus de la fenêtre
MOD Modification de taille de la fenêtre

Exécuter le traitement d'une page (syntaxe conservée par compatibilité) Masquer les détails

Exécute(<Nom de la page> , <Type de traitement>)

<Nom de la page> : Chaîne de caractères

Nom de la page dont il faut exécuter un traitement. Si ce nom n'est pas spécifié, le traitement de la page en cours est lancé.

<Type de traitement> : Chaîne de caractères

Traitement à exécuter :
INF Ouverture de la page
FEF Fermeture de la page
Cette constante n'est pas disponible.
PRF Prise de focus de la page
Cette constante n'est pas disponible.
PEF Perte de focus de la page
Cette constante n'est pas disponible.
MOD Modification de taille de la page
Cette constante n'est pas disponible.
CLI Clic (OnClick)
Cette constante n'est pas disponible.
DBL Double clic (OnDblClick)
Cette constante n'est pas disponible.
KDN Touche enfoncée (OnKeyDown)
Cette constante n'est pas disponible.
KPR Touche enfoncée et relâchée (OnKeyPressed)
Cette constante n'est pas disponible.
KUP Touche relâchée (OnKeyUp)
Cette constante n'est pas disponible.
MDN Bouton de la souris enfoncé (OnMouseDown)
Cette constante n'est pas disponible.
MMV Souris bouge au-dessus du champ (OnMouseMove)
Cette constante n'est pas disponible.
MOU Souris sort du champ (OnMouseOut)
Cette constante n'est pas disponible.
MOV Souris entre sur le champ (OnMouseOver)
Cette constante n'est pas disponible.
MUP Bouton de la souris relevé (OnMouseUp)
Cette constante n'est pas disponible.
BLU Perte de focus (OnBlur)
Cette constante n'est pas disponible.
CHG Modification (OnChange)
Cette constante n'est pas disponible.
FOC Prise de focus (OnFocus)
Cette constante n'est pas disponible.
SEL Texte sélectionné (OnSelect)
Cette constante n'est pas disponible.
HLP Touche F1 (OnHelp)
Cette constante n'est pas disponible.
LOD Chargement de la page (OnLoad)
Cette constante n'est pas disponible.
UNL Déchargement de la page (OnUnload)
Cette constante n'est pas disponible.
RES Réinitialisation de la page (OnReset)
Cette constante n'est pas disponible.
SUB Validation de la page (OnSubmit)
Cette constante n'est pas disponible.

Remarques

Exécuter l'événement associé à un champ ou une procédure d'une fenêtre (ou d'une page) différente de la fenêtre (ou de la page) en cours

Il est possible d'exécuter l'événement associé à un champ ou une procédure d'une fenêtre (ou d'une page) différente de la fenêtre (ou de la page) en cours. Il suffit de préfixer le nom du champ ou de la procédure par le nom de la fenêtre (ou de la page).

Par exemple :

// Exécuter l'événement "Clic" du bouton Valider de MaSoeur (fenêtre ou page ouverte)
Exécute("MaSoeur.Valider..CLI")

// Exécuter la procédure PROC1 de MaSoeur (fenêtre ou page ouverte)
Exécute("MaSoeur.PROC1")

Il n'est pas possible d'exécuter un événement WLangage associé à un champ présent sur une page différente de la page en cours.

Chaîne passée en paramètre à la fonction Exécute

La chaîne passée en paramètre à la fonction Exécute ne peut pas être une chaîne construite ou une variable. Il est nécessaire d'utiliser directement la chaîne contenant le nom du champ, de la fenêtre ou de la page et le traitement/événement à exécuter.

// Code correct
Exécute("Saisie2..Sortie")

// Code incorrect
i est un entier = 5
Exécute("Saisie" + i + "..Sortie")

Les tableaux

La fonction Exécute ne reconnaît pas les tableaux.

Par exemple :

var_tab est un tableau de 10 chaînes
// Appel une procédure MAPROC avec un tableau passé en paramètre
MAPROC(var_tab)
// L'instruction suivante provoque une erreur
Exécute("MAPROC..PRO", var_tab)

Ouverture de la fenêtre/page

La fonction Exécute ne doit pas être appelée pour exécuter l'événement WLangage d'ouverture d'une fenêtre/page car les variables globales risquent d'être ré-initialisées. Il faut dans ce cas utiliser des procédures.

Appeler une procédure globale de composant

La fonction Exécute permet d'appeler une procédure globale de composant. Il suffit d'utiliser la syntaxe suivante :

Exécute(<Nom Composant>.<Nom Collection de procédures>.<Nom Procédure>)

Exemple :

Exécute("MonComposant.Collection_WDExemple.MaProcé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écute.

Il est nécessaire d'utiliser un procédure globale du projet hôte qui rappelle la procédure locale de la fenêtre.

Utilisation de fonctions spécifiques

Si l'appel de la fonction Exécute est précédé par les fonctions EmailOuvreMessagerie et PageValide, ces fonctions seront ignorées si le code appelé par la fonction Exécute contient les fonctions PageValide et EmailOuvreMessagerie. En effet, les navigateurs autorisent uniquement une action par page. Seule la dernière action demandée sera effectuée.

Exécution de l'événement associé à un champ

Si le paramètre <Nom du champ> correspond à un bouton, l'exécution du code de clic sera similaire au clic sur le bouton. Si un code serveur (ou une action s'exécutant sur le serveur) est associée au bouton, ce code sera donc exécuté.

Composante : wd300vm.dll

Voir Aussi

Version minimum requise

Version 9

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

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