PC SOFT

ONLINE HELP
 WINDEV, WEBDEV AND WINDEV MOBILE
  • Overview
  • Events managed by default
  • Events supported by WINDEV and WINDEV Mobile
  • Optional events
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
Processes associated with HTML Display controls
Overview
WINDEV and WINDEV Mobile offer different WLanguage events associated with HTML Display Controls.
Events managed by default

Events supported by WINDEV and WINDEV Mobile

The following events are proposed by default (in order of appearance in the code editor):
EventRuntime condition
InitializingRun when the window is opened. *
Click on a linkRun when a link is clicked on in the HTML Display control. Only external links (to another page) trigger this event. Internal links (to an anchor in the same page for example) do not trigger this event.
This event accepts parameters:
PROCEDURE ClickLink(sURL is string, bInNewWindow is boolean,
sDestination is string)
where <sURL> is an optional string that contains the URL of the link clicked in the HTML Display control.
If this event returns False, the action associated with the link will not be performed.
Caution: the code must not contain slow processes or process that allow the control to regain focus. In this case, the default action will still be performed.
Android Remarks:
  • The code in the "Click on link" event must not execute a blocking process (e.g. display a dialog box).
  • This event is run from Android version 7.0 (Nougat).
    Reminder: To determine the version of Android the application is running on, use SysAndroidVersion.
  • This event will not be called if the link that was clicked corresponds to an anchor link in the page.
  • Only the clicks by the user trigger the call to the event. A click "simulated" from JavaScript code for example will not trigger the call to the event.
Code example:
// Open links with a new window as destination,
// in another specific window of the application
PROCEDURE ClickLink(sURL is string, bInNewWindow is boolean,
sDestination is string)
IF bInNewWindow THEN
// Open another requested window:
// opening process of the other window,
// delayed so that the current process responds
// before opening the new window
OpenNewBrowser(sURL)
RESULT False // Overrides default behavior
ELSE
RESULT True // Keeps default behavior
END
 
INTERNAL PROCEDURE DisplayNewBrowser(sURLParam) <delay=10ms>
// Important: specify a delay, even if it is very small
<COMPILE IF ConfigurationType = Android OR ConfigurationType = iOS>
OpenMobileWindow(WIN_POPUP, sURLParam)
<ELSE>
OpenChild(WIN_POPUP. sURLParam)
<END>
END
Before loading the HTML pageRun before loading the HTML document in the HTML Display control. If the user navigates using links in the HTML Display control, this event is run once each HTML document displayed in the control has been loaded.
This event accepts parameters:
PROCEDURE ChangePage(sURL is string, sDestination is string)
where <sURL> is an optional string that contains the URL of the page to be displayed.
If this event returns False, the page will not load.
After loading the HTML pageRun after the HTML document has been loaded in the HTML Display control. If the user navigates using links in the HTML Display control, this event is run once each HTML document displayed in the control has been loaded.
Load resourcesAllows you to be notified and prevent application scripts or images from being loaded (for security purposes, for example).
This event accepts parameters:
PROCEDURE LoadResources(sURL is string, nType is int)
where:
  • <sURL> is a character string that corresponds to the URL of the resource to load.
  • <nType> is a constant used to identify the type of resource to be downloaded:
    • typehtmlImageRes: the resource to download is an image.
    • typehtmlScriptRes: the resource to download is a script.
    • typehtmlCssRes: the resource to download is a CSS style.
    • typehtmlXMLHttpRequestRes: the resource to download is an XML document generated as response to an HTTP request.
    • typehtmlOther: the resource to download is of an unknown type.
If this event returns False, the resource will not be loaded.
Right click on a link Run when the user right-clicks on a link (to open a context menu). This event has the following format:
PROCEDURE RightClickLink(sURL is string)
where <sURL> is a string that contains the URL of the link.

(*) By default, the "Initializing" event of each control is run according to the order in which the controls were created in the window. To modify this order of execution:
  1. On the "Window" tab, in the "Order" group, click "Initialization".
  2. In the window displayed, use the arrows on the right to modify the order in which the controls are initialized.
Optional events
WINDEVAndroidiPhone/iPad Several optional events are supported. To add an optional event:
  1. Select the desired control.
  2. Display the code window of this control (F2 key).
  3. Click the link "Add other events to xxx" at the bottom of the window code, after the last event.
  4. All the optional events available for the control are displayed.
  5. Check the optional event to add and validate.
    Remark: You can select several optional events.
  6. The selected optional event is automatically added to the events managed by the control.
To disable an optional event, simply perform the same operations to display the list of optional events. Then simply uncheck the optional events to delete.
Remark: If the disabled code contains WLanguage code, this code is automatically deleted.
You can manage, for example:
  • the mouse hover over the control,
  • left mouse button down, up, with a double click,
  • right mouse button down, up, double click,
  • mouse wheel, etc.
See also
Minimum version required
  • Version 26
This page is also available for…
Comments
Click [Add] to post a comment