ExecuteProcess (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Standard functions

Windows management functions

Miscellaneous WINDEV functions

ExecuteProcess

Presentation

Example

Calling a global component procedure

See also

ExecuteProcess (Function)

In french: ExécuteTraitement

Starts the execution of an event or process programmatically, i.e. without the user having to perform any particular action in the interface. The event/process executed can be:

an event of a control (in a window, a page or a report),
an event of a menu option,
an event of a report block,
an event of a window,
an event of a page,
an event of a report,
a process of a procedure.
Remark: To execute of a procedure in the main thread of the application, use:
- the ExecuteMainThread function.
- New in version 28
  the ExecuteMainThreadAsynchronous function.

Example

// Exécute le traitement de clic sur un champ Bouton
ExecuteProcess(BTN_Sauve, trtClick)

// Exécute le traitement de clic sur un champ via indirection
ExecuteProcess({NChamp}..Value, trtClick)

// Exécute une procédure locale (test) appartenant
// à une autre fenêtre/page ouverte (menu)
ExecuteProcess(Menu.Test, trtProcédure)

// Exécute la procédure LitFichier
// en lui passant en paramètre le nom du fichier
ExecuteProcess(LitFichier, trtProcédure, NomFichier)

Syntax

Executing an event associated with a control Hide the details

ExecuteProcess(<Control used> , <Process> [, <Parameter 1> [... [, <Parameter N>]]])

<Control used>: Control name

Name of the control (or menu option) associated with the process (or event) to run.
For an option in a popup menu, use the following notation: <Name of popup menu>.<Option name>.
Caution: If the name of the control is not directly specified (with an indirection, for example), you must explicitly use the Value property.

<Process>: Integer constant

Event to be executed among the WLanguage events available for controls:
trtAction Action code of Web Component control. This code is available in server code and in browser code.
trtAddDiagShape Code for adding a shape in a Diagram Editor control.
New in version 28
trtAddKanbanCard
Code for adding a card to an control Kanban.
trtAddToken Code for adding a token into a "Text token" edit control.
trtAddWidget Code for adding a widget to a Dashboard control.
trtAfterOpeningDocument "After opening document" code of Word Processing control, Image Editor control, Spreadsheet control or PDF Reader control.
trtBeforeClosingDocument "Before closing document" code of Word Processing control, Image Editor control, Spreadsheet control or PDF Reader control.
trtBeforeCreatingOrganizerApt "Before creating the appointment" code of the Organizer control.
trtBeforeCreatingScheduleApt "Before creating the appointment" code of Scheduler control.
trtChange "Whenever modified" code of control.
trtChangeDiagShape Code for changing a shape in a Diagram Editor control.
trtChangeOrganizerPeriod "Whenever changing period" code of Organizer control.
trtChangePlane "Whenever changing plane" code of a Sliding Banner control.
trtChangePositionMap "Whenever changing position" code of Map control.
trtChangeSchedulePeriod "Whenever changing period" code of Scheduler control.
trtClick Click code of control.
trtClickButtonArrow Click code on the arrow associated with a button.
trtClickHTMLLink "Click on a link" code of an HTML Display control.
trtClickToken Click code on a token in a "Text token" Edit control.
trtCollapseExpandBranch Collapsed/Expanded code of a node in a TreeView or TreeView Table control.
Caution: This parameter requires a specific syntax. For more details, see the remarks.
trtCollapseExpandBreak Collapsed/Expanded code of a break in a Looper or Table control.
trtCollapseExpandDrawer Browser code run each time the Drawer control is collapsed or expanded.
trtComboClosing Closing code of drop-down list.
trtComboOpening Code for opening the drop-down list of Combo Box control.
trtDelayedPlaneLoad "Delayed plane load" code of a plane.
trtDeleteDiagShape Code for deleting a shape in a Diagram Editor control.
New in version 28
trtDeleteKanbanCard
Code to delete a card in an control Kanban.
trtDeleteOrganizerApt Code for deleting an appointment from an Organizer control.
trtDeleteScheduleApt Code for deleting an appointment from a Scheduler control.
trtDeleteToken Code for deleting a token from a "Text token" Edit control.
trtDeleteWidget Code for deleting a widget from a Dashboard control.
trtDoubleClick Double-click code.
trtEndChange "End of modification" code (Slider and Scrollbar control only).
trtEndInitialization "End of initialization" code (browsing List Box, Table and Combo Box control).
trtEndLoadingHTMLPage "After loading the HTML page" code of an HTML Display control.
New in version 28
trtEndMovingKanbanCard
Code for the end of the movement of a card in an control Kanban.
trtEnter Entry code in the control.
trtEnterInputOrganizerApt Entry code in input for an appointment in an Organizer control.
trtEnterInputSchedulerApt Entry code in input for an appointment in a Scheduler control.
trtExit Exit code of control.
trtInit Initialization code of control.
New in version 28
trtKanbanCardDetails
Code for displaying the details of a card in an control Kanban.
trtLineDisplay Code used to display a row (Table control only).
trtLineEnter Entry code of a row (Table control only).
trtLineExit Exit code of row (Table control only).
trtLoadingHTMLResource "Load resources" code of an HTML Editor or HTML Display control.
trtMenuOption Code of menu option (main or context menu).
trtModificationColumnFilter Code "Whenever modifying the filter (user input in header)" of a Table Column control.
trtModificationSpreadsheetCell "Cell modification" code of Spreadsheet control.
trtMoveDiagShape Code for moving a shape in a Diagram Editor control.
New in version 28
trtMoveKanbanCard
Code for moving a card in an control Kanban.
trtMoveOrganizerApt Code for moving an appointment in an Organizer control.
trtMoveScheduleApt Code for moving an appointment in a Scheduler control.
trtMoveWidget "Moving a widget" code of Dashboard control.
trtOrganizerInputExitApt Exit code from input for an appoingment in an Organizer control.
trtPullToRefresh "Pull to refresh" code of a Table or Looper control.
trtReadFirst Code for reading the first record (Table control only).
trtReadLast Code for reading the last record (Table control only)
trtReadNext Code for reading the next record (Table control only).
trtReadPrevious Code for reading the previous record (Table control only).
trtReassignResourceScheduleApt Code for re-assigning an appointment in a Scheduler control.
trtRefreshRibbon Code for refreshing the ribbon of PDF Reader and Word Processing controls.
trtResizeDiagShape Code for resizing a shape in a Diagram Editor control.
trtResizeOrganizerApt Code for resizing an appointment in an Organizer control.
trtResizeScheduleApt Code for resizing an appointment in a Scheduler control.
trtResizeWidget "Resizing a widget" code of Dashboard control.
trtRightClick Right-click code (for the TreeView control only).
trtRightClickHTMLLink "Right click on a link" code of an HTML Display control.
trtScheduleInputExitApt Exit code from input for an appoingment in a Scheduler control.
trtSelectDiagShape Code for selecting a shape in a Diagram Editor control.
trtSelection Selection code (Combo Box, List Box and Table control).
trtSelectOrganizerApt Code for selecting an appointment in an Organizer control.
trtSelectOrganizerPeriod Code for selecting a period in an Organizer control.
trtSelectScheduleApt Code for selecting an appointment in a Scheduler control.
trtSelectSchedulePeriod Code for selecting a period in a Scheduler control.
trtSliderChange "Whenever modified" code (Slider control only).
trtSpinMinus Decrement code of Spin control.
trtSpinPlus Increment code of Spin control.
trtStartLoadingHTMLPage "Before loading the HTML page" code of an HTML Display control.
New in version 28
trtStartMovingKanbanCard
Code to start moving a card in an control Kanban.
trtValueAssignment Code for assigning the Value property of Web Component control. This code is available in browser code only.
trtValueRetrieval Code for retrieving the Value property of a Web Component control. This code is available in browser code only.
trtZoomModification Code for modifying the zoom of a Range Slider control.

Control or block of a report: Event to be executed among the available WLanguage events:
trtPostPrint "Post Print" code of a block.
trtPrePrint "Pre Print" code of control or block.

<Parameter 1>: Any optional type

First optional parameter to be passed to the code (for WLanguage events that expect parameters).

<Parameter N>: Any optional type

Nth optional parameter to be passed to the code (for WLanguage events that expect parameters).

Executing a WLanguage event associated with a window Hide the details

ExecuteProcess(<Window used> , <Process> [, <Parameter 1> [... [, <Parameter N>]]])

<Window used>: Window name

Name of the window with a WLanguage event to be executed.

<Process>: Integer constant

Event to be executed among the WLanguage events available for windows.
trtBeforeClosingWindow "Allow closing" code.
trtChange Modification code of the window.
trtChangeLayout "Change of layout" code.
trtClick Code of the button associated with the click in the window.
trtClosing Closing code of the window.
trtDoubleClick Code of button associated with the double click in the window.
trtGetFocus Code of focus gain for the window.
trtKillFocus Code of focus loss for the window.
trtOpening or trtInit Initialization code of the window.
trtRequestRefresh "Request for updating the display" code.
trtResize Code for resizing the window.
trtRightClick Code of button associated with the right click in the window.
trtSystemButton "Before closing with OK/Close button" code.

<Parameter 1>: Any optional type

First optional parameter to be passed to the code (for WLanguage events that expect parameters).

<Parameter N>: Any optional type

Nth optional parameter to be passed to the code (for WLanguage events that expect parameters).

Executing a WLanguage event associated with a report Hide the details

ExecuteProcess(<Report used> , <Process> [, <Parameter 1> [... [, <Parameter N>]]])

<Report used>: Report name

Name of the report whose process must be run.

<Process>: Integer constant

event to be executed among the WLanguage events available for reports.
trtClosing Closing code of report.
trtFilter Code for filtering the report data.
trtOpening or trtInit Opening code of report.
trtReadData Code for reading the report data.

<Parameter 1>: Any optional type

First optional parameter to be passed to the code (for WLanguage events that expect parameters).

<Parameter N>: Any optional type

Nth optional parameter to be passed to the code (for WLanguage events that expect parameters).

Executing a WLanguage procedure Hide the details

<Result> = ExecuteProcess(<WLanguage procedure> , <Process> [, <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 procedure to execute.

<Process>: Integer constant

Procedure to run. This procedure corresponds to:
one of the following constants:
trtProcedure Run the specified procedure according to the execution context (procedure of the window, procedure of the WINDEV/WEBDEV component or procedure of the project).
trtProjectProcedure Runs the specified procedure. This procedure is a procedure of the project that is hosting the WINDEV/WEBDEV component.
This parameter can only be used for a WINDEV/WEBDEV component included in another project.
a variable of type Procedure Description (usable only to execute a class method). For more details, see Enumerating and handling the objects of a class.

<Parameter 1>: Any optional type

First optional parameter that will be passed to the procedure.

<Parameter N>: Any optional type

Nth optional parameter that will be passed to the procedure.

Remarks

Calling a global component procedure

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

ExécuteTraitement(<Composant>.<Collection de procédures>.<Procédure>, ...
trtProcédure)

Example:

ExecuteProcess("MonComposant.Collection_WDExemple.MaProcédure", trtProcédure)

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

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

Business / UI classification: Neutral code

Component: wd280vm.dll