Execute (Function)

Running the process of a control or procedure belonging to a window (or to a page) other than the current window (or page)
String passed in parameter to Execute
The arrays
Opening process of 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

// Run a procedure
Execute("Proced1")

// -- Click on BTN_BUTTON1 button
// Run a procedure that returns a result
Info(Execute("Double_Number", 2)) // Displays 4

// Double_Number procedure
PROCEDURE Double_Number(X)
RESULT 2*X

Syntax

Running a procedure that may return a result Hide the details

<Result> = Execute(<Procedure name> [, <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.

<Procedure name>: Character string (with quotes)

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

Running the process of a control or procedure belonging to a window (or to a page) other than the current window (or page)

You have the ability to run the process of a control or procedure belonging to a window (or to a page) other than 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:

// Run the process of the Validate button found in MySibling (opened window or page)
Execute("MySibling.Validate..CLI")

// Run the PROC1 procedure of MySibling (opened window or page)
Execute("MySibling.PROC1")

String passed in parameter to Execute

The string passed in parameter to Execute cannot be a built string or a variable. You must use the string that contains the name of control, window or page as well as the process to run.

// Correct code
Execute("Edit2..Exit")

// Incorrect code
i is int = 5
Execute("Edit" + i + "..Exit")

The arrays

The arrays are not recognized by Execute.

For example:

var_arr is array of 10 strings
// Call the MYPROC procedure with an array passed in parameter
MYPROC(var_arr)
// The following statement triggers an error
Execute("MYPROC..PRO", var_arr)

Opening process of window/page

Execute must not be called to run the opening process of a window/page because the global variables may be re-initialized. 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:

Execute(<Component name>.<Name of set of procedures>.<Procedure name>)

Example:

Execute("MyComponent.Set_WDExample.MyProcedure")

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 : wd250vm.dll