PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
New WINDEV and WINDEV Mobile 26 feature!
  • 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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Processes associated with HTML Display controls
Overview
WINDEV and WINDEV Mobile offer different WLanguage events associated with HTML Display Controls.
Versions 16 and later
Android The HTML control is now available for Android applications.
New in version 16
Android The HTML control is now available for Android applications.
Android The HTML control is now available for Android applications.
Versions 17 and later
iPhone/iPad The HTML control is now available for iPhone/iPad applications.
New in version 17
iPhone/iPad The HTML control is now available for iPhone/iPad applications.
iPhone/iPad The HTML control is now available for iPhone/iPad applications.
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. This event has the following format:
PROCEDURE ClickLink(sURL 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.
Android Remarks:
  • The code in "Click on link" must not perform a locking 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.
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. This event has the following format:
PROCEDURE ChangePage(sURL 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 resources Allows you to be notified and prevent application scripts or images from being loaded (for security purposes, for example).
This event accepts parameters. This event has the following format:
PROCEDURE DownloadResources(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" pane, 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 can be managed. To add an optional event:
  1. Select the requested 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,
  • the right mouse button down, up, with double click,
  • the mouse wheel, etc.
Minimum version required
  • Version 26
This page is also available for…
Comments
Click [Add] to post a comment