ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / Developing an application or website / Controls, windows and pages / Controls: Available types / Supercontrol
  • Default events
  • Associating a local procedure with a supercontrol
  • Optional events
  • Overview
  • Optional event: Start of scrolling
  • Optional event: While scrolling
  • Optional event: End of scrolling
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
Events associated with supercontrols
Default events
WINDEVWINDEV Mobile WINDEV and WINDEV Mobile manage the following events by default (order of appearance in the code editor):
EventRuntime condition
Declaration of global variablesDeclaration code of global variables of supercontrol. All the types of variables are supported. They can be used in any event associated with the supercontrol or with one of the controls included in the supercontrol.
InitializationRun when opening the window.
Request for refreshing the displayAllows you to group the update code of the fields of the superfield: contents of controls, state (visible, grayed out...), text to refresh, etc.
This event can receive parameters. Simply declare a procedure in the event. For example:
// Request for refreshing the display
PROCEDURE AskForRefresh(RefreshType is boolean)
This event is started upon request by the following functions:
When these functions are called, you can specify the value of the parameters expected by the event.
EntryRun when the cursor enters a control that is included in the supercontrol
ExitRun when the cursor exits from one of the controls that is included in the supercontrol
Set the Value propertyExecuted at each assignment of the Property Value on the superfield (direct assignment or performed with the Property Value). This code allows for example to retrieve parameters passed to the superfield.
Get the Value propertyExecuted each time the Value property of the internal window is retrieved. This code allows for example the superfield to return a value to the window hosting the superfield.
With each modificationThis code is not run by default. To run it, use ExecuteProcess associated with the trtChange constant.
WEBDEV - Server code WEBDEV manages the following events by default (order of appearance in the code editor):
EventRuntime condition
Global declarations (Server code)Declaration code of global variables of supercontrol. All the types of variables are supported. They can be used in any event associated with the supercontrol or with one of the controls included in the supercontrol.
Initializing (Server code)Executed when the page is opened.
Load (browser code)Executed when the page is loaded.
Remark: In a static page, only optional browser events will be available.
Associating a local procedure with a supercontrol
To create a procedure local to the supercontrol:
  1. Display the supercontrol description.
  2. Click the "Add" button found below the "Local procedures" control. A new procedure is created.
  3. Click the "Code" button to edit the procedure code.
Tip: To create local procedures linked to the supercontrol, you can perform the following operations:
  1. Select your window (or page) and the supercontrol in the "Project explorer" pane.
  2. Click the black arrow found beside the supercontrol name in the project explorer. The local procedures appear.
  3. Select "Local procedures". The local procedures displayed are the ones of supercontrol. You have the ability to add, rename or delete local procedures in the supercontrol.
Optional events

Overview

Several optional events can be managed.
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, double click,
  • right mouse button down, up, double click,
  • the mouse wheel, etc.

Optional event: Start of scrolling

Executed at the start of the vertical scrollbar of the superfield, used to scroll the content of the superfield (case where the content of the superfield is larger than the size of the superfield).
Reminder: The ScrollbarPosition function allows to know the position of the elevator.

Optional event: While scrolling

Executed when scrolling the superfield vertical scrollbar, used to scroll the superfield content (case where the superfield content is larger than the superfield size).
Reminder: The ScrollbarPosition function allows to know the position of the elevator.

Optional event: End of scrolling

Executed at the end scrolling of the superfield vertical scrollbar, used to scroll the content of the superfield (case where the content of the superfield is larger than the size of the superfield).
Reminder: The ScrollbarPosition function allows to know the position of the elevator.
See also
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/24/2022

Send a report | Local help