Execute (Function)

Execute the event associated with a field or an Procedure of a window (or page) different from the current window (or page)
String passed as a parameter to the Execute function
The arrays
Open window/page
Calling a global component procedure

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Execute (Function)

In french: Execute

Starts the execution of a process by programming. This function is mainly used to run procedures.

For backward compatibility, the process run can also be the process of a control, window or page. In these different cases, we recommend that you use ExecuteProcess.

Versions 18 and later

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Windows Store apps mode.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Example

// 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)
RETURN 2*X

Syntax

Running a procedure that may return a result Hide the details

<Result> = Execute(<WLanguage procedure> [, <Parameter 1> [... [, <Parameter N>]]])

<Result>: Any

Return value of procedure called. This value is identical to the value obtained if the procedure is run directly.

<WLanguage procedure>: Procedure name

Name of WLanguage procedure to run. This procedure returns a result.

<Parameter 1>: Any optional type

First optional parameter that will be passed to the procedure. These parameters are always passed by value.

<Parameter N>: Any optional type

Nth optional parameter that will be passed to the procedure. These parameters are always passed by value.

Running the process of a control (syntax kept for backward compatibility) Hide the details

Execute(<Control name> , <Process>)

<Control name>: Character string (without quotes)

Name of control associated with the process to run.

<Process>: Character string (without quotes)

Process to run:
Click Click code of control (or menu option)
Exit Exit code of control
Entry Entry code of control
Initialization Initialization code of control
Previous Code used to read the previous record (browsing table in programmed browse only)

Next Code used to read the next record (browsing table in programmed browse only)

Display Code used to display a row (table only)
RExit Code used to exit from a table row
REntry Code used to enter in a table row
END Code used to read the last record (table only)
Modify Whenever Modified code of control
DBL Code for double-clicking a treeview element
CLD Code for right-clicking a treeview element
CLI Click (OnClick) (browser code)
This constant is not available.
KDN Key down (OnKeyDown) (browser code)
This constant is not available.
KPR Key pressed and released (OnKeyPressed) (browser code)
This constant is not available.
KUP Key up (OnKeyUp) (browser code)
This constant is not available.
MDN Mouse button down (OnMouseDown) (browser code)
This constant is not available.
MMV Mouse moves over the control (OnMouseMove) (browser code)
This constant is not available.
MOU Mouse exits from the control (OnMouseOut) (browser code)
This constant is not available.
MOV Mouse enters in the control (OnMouseOver) (browser code)
This constant is not available.
MUP Mouse button up (OnMouseUp) (browser code)
This constant is not available.
BLU Loss of focus (OnBlur) (browser code)
This constant is not available.
CHG Modification (OnChange) (browser code)
This constant is not available.
FOC Gain of focus (OnFocus) (browser code)
This constant is not available.
SEL Selected text (OnSelect) (browser code)
This constant is not available.
HLP F1 key (OnHelp) (browser code)
This constant is not available.

Running the process of a window (syntax kept for backward compatibility) Hide the details

Execute([<Window name>, ] <Type of process>)

<Window name>: Optional character string (without quotes)

Name of the window whose process must be run. If this name is not specified, the process of current window is run.

<Type of process>: Character string (without quotes)

Process to run:
INF Opening the window
FEF Closing the window
PRF The window takes focus
PEF The window loses focus
MOD Resizing the window

Remarks

Execute the event associated with a field or an Procedure of a window (or page) different from the current window (or page)

It is possible to execute the event associated with a field or an Procedure of a window (or page) different from the current window (or page). To do so, the control name or the procedure name must be prefixed with the name of the window (or page).

For example:

// 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")

String passed as a parameter to the Execute function

The string passed in parameter to Execute cannot be a built string or a variable. It is necessary to use directly the string containing the name of the control, the window or the page and the treatment/event to be executed.

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

// Code incorrect
i is int = 5
Exécute("Saisie" + i + "..Sortie")

The arrays

The arrays are not recognized by Execute.

For example:

var_tab is array of 10 strings
// 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)

Open window/page

The Execute function should not be called to execute the WLanguage event to open a window/page because the global variables may be reset. Procedures must be used in this case.

Calling a global component procedure

Execute is used to call a global component procedure. To do so, use the following syntax:

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

Example:

Exécute("MonComposant.Collection_WDExemple.MaProcédure")

In a thread started by a component, Execute cannot be used to call a local procedure of a window of the host project.

You must use a global procedure of the host project to call the local procedure of the window.

Component: wd260vm.dll