Execute (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Standard functions / Windows functions / Miscellaneous WINDEV functions

Executing the event of a control or procedure from a window/page other than the current window/page
String passed as a parameter to Execute
The arrays
Opening the 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 programmatically. 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.

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

Name of control associated with the process to run.

<Process>: Character string

Process to run:
Click Click code of control (or menu option)
Exit Exit code of control
Entry Entry code of control
Initialization Control initialization code
Previous Code used to read the previous record (table based on a data file in programmed iteration only)

Next Code used to read the next record (table based on a data file in programmed iteration 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

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

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

Remarks

Executing the event of a control or procedure from a window/page other than the current window/page

You can execute the event of a control or procedure from a window/page other than the current window/page. To do so, the control name or the procedure name must be prefixed with the name of the window (or page).

For example:

// Execute the "Click" event of the Validate button in MySibling (open window or page)
Execute("MySibling.Validate..CLI")

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

String passed as a parameter to Execute

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

// 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 as parameter
MYPROC(var_arr)
// The following statement triggers an error
Execute("MYPROC..PRO", var_arr)

Opening the window/page

Execute should not be called to execute the WLanguage event to open a window/page because the global variables may be reset. In this case, use procedures instead.

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