ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE


  • Executing the "Collapse/Expand" event
  • Calling a global component procedure
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
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:
Java The event/process executed can only be from a control in a window, from a menu option, from a window or a procedure.
Example
// Execute the click process of a Button control
ExecuteProcess(BTN_Save, trtClick)
 
// Execute the click process of a control via indirection
ExecuteProcess({NControl}..Value, trtClick)
// Runs a local procedure (test) that belongs
// to another opened window/page (menu)
ExecuteProcess(Menu.Test, trtProcédure)
// Runs the ReadFile procedure
// and passes the file name as parameter
ExecuteProcess(ReadFile, trtProcédure, FileName)
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:
trtActionAction code of the Web Component control. This code is available in server code and in browser code.
WINDEVUniversal Windows 10 AppJava This constant is not available.
trtAddDiagShapeCode executed when a shape is added in a Diagram Editor control.
Universal Windows 10 AppJava This constant is not available.
New in version 28
trtAddKanbanCard
Code executed when a card is added in a Kanban control.
Universal Windows 10 AppJava This constant is not available.
trtAddTokenCode executed when a token is added in a "Text token" Edit control.
Universal Windows 10 AppJava This constant is not available.
trtAddWidgetCode executed when a widget is added to a Dashboard control.
Universal Windows 10 AppJava This constant is not available.
trtAfterOpeningDocument"After opening a document" code of the Word Processing, Image Editor, Spreadsheet and PDF Reader controls.
Universal Windows 10 AppJava This constant is not available.
trtBeforeClosingDocument"Before closing a document" code of the Word Processing, Image Editor, Spreadsheet and PDF Reader controls.
Universal Windows 10 AppJava This constant is not available.
trtBeforeCreatingOrganizerApt"Before creating the appointment" code of the Organizer control.
Universal Windows 10 AppJava This constant is not available.
trtBeforeCreatingScheduleApt"Before creating the appointment" code of Scheduler control.
Universal Windows 10 AppJava This constant is not available.
trtChange"Whenever modified" code of control.
trtChangeDiagShapeCode executed when a shape is modified in a Diagram Editor control.
Universal Windows 10 AppJava This constant is not available.
trtChangeOrganizerPeriod"Whenever changing period" code of Organizer control.
Universal Windows 10 AppJava This constant is not available.
trtChangePlane"Whenever changing plane" code of a Sliding Banner control.
WINDEVUniversal Windows 10 AppJava This constant is not available.
trtChangePositionMap"Whenever changing position" code of Map control.
Java This constant is not available.
trtChangeSchedulePeriod"Whenever changing period" code of Scheduler control.
Universal Windows 10 AppJava This constant is not available.
trtClickClick code of the control.
trtClickButtonArrowClick code on the arrow associated with a button.
Universal Windows 10 AppJava This constant is not available.
trtClickHTMLLink"Click on a link" code of an HTML Display control.
Universal Windows 10 AppJava This constant is not available.
trtClickTokenClick code on a token in a "Text token" Edit control.
Java This constant is not available.
trtCollapseExpandBranchCollapsed/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.
Universal Windows 10 AppJava This constant is not available.
trtCollapseExpandBreakCollapsed/Expanded code of a break in a Looper or Table control.
Universal Windows 10 AppJava This constant is not available.
trtCollapseExpandDrawerBrowser code run each time the Drawer control is collapsed or expanded.
WINDEVUniversal Windows 10 AppJava This constant is not available.
trtComboClosingCode executed when the drop-down list is closed.
trtComboOpeningCode executed the drop-down list of a Combo Box control is expanded.
trtDelayedPlaneLoad"Delayed plane load" code of a plane.
WINDEVUniversal Windows 10 AppJava This constant is not available.
trtDeleteDiagShapeCode executed when a shape is deleted from a Diagram Editor control.
Universal Windows 10 AppJava This constant is not available.
New in version 28
trtDeleteKanbanCard
Code executed when a card is deleted from a Kanban control.
Universal Windows 10 AppJava This constant is not available.
trtDeleteOrganizerAptCode executed when an appointment is deleted from an Organizer control.
Universal Windows 10 AppJava This constant is not available.
trtDeleteScheduleAptCode executed when an appointment is deleted from a Scheduler control.
Universal Windows 10 AppJava This constant is not available.
trtDeleteTokenCode executed when a token is deleted from a "Text token" Edit control.
Universal Windows 10 AppJava This constant is not available.
trtDeleteWidgetCode executed when a widget is deleted from a Dashboard control.
Universal Windows 10 AppJava This constant is not available.
trtDoubleClickDouble-click code.
Universal Windows 10 App This constant is not available.
trtEndChange"End of modification" code (Slider and Scrollbar control only).
Universal Windows 10 App This constant is not available.
trtEndInitialization"End of initialization" code (List Box, Table and Combo Box control based on a data file).
trtEndLoadingHTMLPage"After loading the HTML page" code of an HTML Display control.
Universal Windows 10 AppJava This constant is not available.
New in version 28
trtEndMovingKanbanCard
Code executed when the user stops moving a card in a Kanban control.
Universal Windows 10 AppJava This constant is not available.
trtEnterEntry code of the control.
trtEnterInputOrganizerAptCode executed when the user enters an appointment in an Organizer control.
Universal Windows 10 AppJava This constant is not available.
trtEnterInputSchedulerAptCode executed when the user enters an appointment in a Scheduler control.
Universal Windows 10 AppJava This constant is not available.
trtExitExit code of the control.
trtInitControl initialization code.
New in version 28
trtKanbanCardDetails
Code executed when the details of a card are displayed in a Kanban control.
Universal Windows 10 AppJava This constant is not available.
trtLineDisplayCode executed when a row is displayed (Table control only).
Universal Windows 10 App This constant is not available.
trtLineEnterEntry code of a row (Table control only).
Universal Windows 10 AppJava This constant is not available.
trtLineExitExit code of the row (Table control only).
Universal Windows 10 App This constant is not available.
trtLoadingHTMLResource"Load resources" code of an HTML Editor or HTML Display control.
Universal Windows 10 AppJava This constant is not available.
trtMenuOptionCode of a menu option (main or context menu).
trtModificationColumnFilterCode "Whenever modifying the filter (user input in header)" of a Table Column control.
Universal Windows 10 AppJava This constant is not available.
trtModificationSpreadsheetCell"Cell modification" code of Spreadsheet control.
Universal Windows 10 AppJava This constant is not available.
trtMoveDiagShapeCode executed when the user moves a shape in a Diagram Editor control.
Universal Windows 10 AppJava This constant is not available.
New in version 28
trtMoveKanbanCard
Code executed when the user moves a card in a Kanban control.
Universal Windows 10 AppJava This constant is not available.
trtMoveOrganizerAptCode executed when the user moves an appointment in an Organizer control.
Universal Windows 10 AppJava This constant is not available.
trtMoveScheduleAptCode executed when the user moves an appointment in a Scheduler control.
Universal Windows 10 AppJava This constant is not available.
trtMoveWidget"Moving a widget" code of Dashboard control.
Universal Windows 10 AppJava This constant is not available.
trtOrganizerInputExitAptCode executed when the user leaves the input field of an appointment in an Organizer control.
Universal Windows 10 AppJava This constant is not available.
trtPullToRefresh"Pull to refresh" code of a Table or Looper control.
Java This constant is not available.
trtReadFirstCode executed when the first record is read (Table control only).
Universal Windows 10 App This constant is not available.
trtReadLastCode executed when the last record is read (Table control only)
Universal Windows 10 App This constant is not available.
trtReadNextCode executed when the next record is read (Table control only).
Universal Windows 10 App This constant is not available.
trtReadPreviousCode executed when the previous record is read (Table control only).
Universal Windows 10 App This constant is not available.
trtReassignResourceScheduleAptCode executed when an appointment is reassigned in a Scheduler control.
Universal Windows 10 AppJava This constant is not available.
trtRefreshRibbonCode executed when the ribbon of the PDF Reader or Word Processing control is refreshed.
Java This constant is not available.
trtResizeDiagShapeCode executed when a shape is resized in a Diagram Editor control.
Universal Windows 10 AppJava This constant is not available.
trtResizeOrganizerAptCode executed when an appointment is resized in an Organizer control.
Universal Windows 10 AppJava This constant is not available.
trtResizeScheduleAptCode executed when an appointment is resized in a Scheduler control.
Universal Windows 10 AppJava This constant is not available.
trtResizeWidget"Resizing a widget" code of Dashboard control.
Universal Windows 10 AppJava This constant is not available.
trtRightClickRight-click code (for TreeView controls only).
Universal Windows 10 App This constant is not available.
trtRightClickHTMLLink"Right click on a link" code of an HTML Display control.
Universal Windows 10 AppJava This constant is not available.
trtScheduleInputExitAptCode executed when the user leaves the input field of an appointment in a Scheduler control.
Universal Windows 10 AppJava This constant is not available.
trtSelectDiagShapeCode executed when a shape is selected in a Diagram Editor control.
Universal Windows 10 AppJava This constant is not available.
trtSelectionSelection code (Combo Box, List Box and Table control).
trtSelectOrganizerAptCode executed when an appointment is selected in an Organizer control.
Universal Windows 10 AppJava This constant is not available.
trtSelectOrganizerPeriodCode executed when a time range is selected in an Organizer control.
Universal Windows 10 AppJava This constant is not available.
trtSelectScheduleAptCode executed when an appointment is selected in a Scheduler control.
Universal Windows 10 AppJava This constant is not available.
trtSelectSchedulePeriodCode executed when a time range is selected in a Scheduler control.
Universal Windows 10 AppJava This constant is not available.
trtSliderChange"Whenever modified" code (Slider control only).
Universal Windows 10 AppJava This constant is not available.
trtSpinMinusCode executed when the value decreases in a Spin control.
Universal Windows 10 App This constant is not available.
trtSpinPlusCode executed when the value increases in a Spin control.
Universal Windows 10 App This constant is not available.
trtStartLoadingHTMLPage"Before loading the HTML page" code of an HTML Display control.
Universal Windows 10 AppJava This constant is not available.
New in version 28
trtStartMovingKanbanCard
Code executed when the user starts moving a card in a Kanban control.
Universal Windows 10 AppJava This constant is not available.
trtValueAssignmentCode executed when the Value property of the Web Component control is assigned. This code is available in browser code only.
WINDEVUniversal Windows 10 AppJava This constant is not available.
trtValueRetrievalCode executed when the Value property of a Web Component control is retrieved. This code is available in browser code only.
WINDEVUniversal Windows 10 AppJava This constant is not available.
trtZoomModificationCode executed when the zoom value changes in a Range Slider control.
Universal Windows 10 AppJava This constant is not available.


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).
WINDEVUniversal Windows 10 AppJavaUser code (UMC)

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.
Java This constant is not available.
trtChangeCode executed when the window is modified.
trtChangeLayout"Change of layout" code.
Universal Windows 10 App This constant is not available.
trtClickCode of the button associated with the click in the window.
trtClosingWindow closing code.
trtDoubleClickCode of the button associated with the double click in the window.
Universal Windows 10 App This constant is not available.
trtGetFocusCode executed when the window gains focus.
Universal Windows 10 App This constant is not available.
trtKillFocusCode executed when the window loses focus.
Universal Windows 10 App This constant is not available.
trtOpening or trtInitWindow initialization code.
trtRequestRefresh"Request for updating the display" code.
trtResizeCode executed when the window is resized.
Universal Windows 10 App This constant is not available.
trtRightClickCode of the button associated with the right click in the window.
Universal Windows 10 App This constant is not available.
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).
WINDEVUser code (UMC)

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.
trtClosingReport closing code.
trtFilterCode executed when the report data is filtered.
trtOpening or trtInitReport opening code.
trtReadDataCode executed when the report data is read.
<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).
WINDEVUniversal Windows 10 AppJavaUser code (UMC)

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:
    trtProcedureRun the specified procedure according to the execution context (procedure of the window, procedure of the WINDEV/WEBDEV component or procedure of the project).
    trtProjectProcedureRuns 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
WINDEVUser code (UMC)

Executing the "Collapse/Expand" event


For a TreeView control
The WLanguage "Collapse / Expand" event of a TreeView control expects the following two parameters:
  • <Element path>: Text variable containing the full path of the element currently collapsed or expanded. Simply specify the name of a variable. It will be automatically initialized at runtime.
  • <Collapsed>: Boolean variable, used to find out the action performed by the user (collapse = True, expand = False). Simply specify the name of a variable. It will be automatically initialized at runtime.
To execute this event with ExecuteProcess, you also need to specify these two parameters. In this case, the following syntax must be used:
ExecuteProcess(<TreeView control>, trtTreeviewExpandCollapse, <Element path>, <Collapsed>)
For more details on the "Collapse / Expand" code of a TreeView control, see WLanguage events associated with a TreeView control.
For a TreeView Table control
The WLanguage "Collapse / Expand" event of a TreeView Table control does not expect any parameters.
To execute this event with ExecuteProcess, use the following syntax:
ExecuteProcess(<TreeView Table control>, trtCollapseExpandBranch)
WINDEVUser code (UMC)

Calling a global component procedure

ExecuteProcess is used to call a global component procedure. To do so, use the following syntax:
ExecuteProcess(<Component>.<Set of procedures>.<Procedure>, ...
trtProcedure)
Example:
ExecuteProcess("MyComponent.Set_WDExample.MyProcedure", 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
Minimum version required
  • Version 9
This page is also available for…
Comments
Dynamically Execute Class Methods using ExecuteProcess()
Hi

In order to dynamically call class methods use the following syntax.
ClassInst is ClassObject
MethodToCall is string = "ClassMethod"
ReturnVal is string (e.g. if the method returns a string value)

ReturnVal = ExecuteProcess(ClassInst,MethodToCall,Param1,Param2, ...)

PeHoBe
28 Oct. 2021