ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / Developing an application or website / Controls, windows and pages / Controls: Available types / Internal Window control
  • Default events
  • Optional events
  • Overview
  • Specific optional events: Pull to refresh
  • Specific optional event: Application of light/dark theme
  • Optional event: Start scrolling
  • Optional event: While scrolling
  • Optional event: Stop 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
Default events
Caution: Do not confuse "Internal Window control" and "Internal window": the "Internal window control" is a type of control while the "Internal window" is a type of window.
WINDEV and WINDEV Mobile manage the following events by default for the "Internal Window" controls:
EventRuntime condition
Selection by swipeInternal window with browse by swipe.
Run once the new internal window was displayed and loaded.
After loading the internal windowRun when the internal window is changed by ChangeSourceWindow. This event is run after the "Global declarations" and "Initializing" events of the new internal window.
This event allows you, for example, to initialize controls or to restore values in the internal window.
ChangeSourceWindow must not be used in this event.
Before unloading the internal windowRun when the internal window is changed by ChangeSourceWindow. This event is run before the closing event of the initial internal window.
This event is used, for example, to save the values present in the internal window.
ChangeSourceWindow must not be used in this event.


WINDEV and WINDEV Mobile manage the following events by default for the Internal Windows:
EventRuntime condition
Declaration of global variablesDeclaration of variables global to the window. This is the first code run when opening the window.
This code is run before the declaration code of the global variables of the host window (window in which the internal window is included).
You can, for example, call a procedure of the internal window from the declaration code of global variables of the host window.
End of initializationRun when the window is opened.
The events are run in the following order:
  • Initializing the window controls
  • Initializing the window
  • Focus gain
ClosingExecuted when closing the window.
Remark: Resuming the input in one of the window controls in this code prevents from closing the window.
WINDEVWINDEV Mobile Request for refreshing the display
Used to group the code for updating the window controls: content of controls, state (visible, grayed, etc.), caption 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.
EntryOptional event:
Run when the cursor enters in the Internal Window control.
ExitOptional event:
Run when changing control (when going from the Internal Window control to another control of the window).
Whenever modifiedRun whenever the control content is modified
Set the Value propertyExecuted each time the Value property is specified for the Internal Wndow (directly or with the Value property). This code is used to retrieve the parameters passed to the internal window for example.
Get the Value propertyExecuted each time the Value property of the internal window is retrieved. This code allows the internal window to return a value to the window that hosts the Internal Window control.
Optional events

Overview

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, double click,
  • right mouse button down, up, double click,
  • mouse wheel, etc.
For more details, see the Optional events.
AndroidiPhone/iPad

Specific optional events: Pull to refresh

When an internal window is used to manage the "Pull to Refresh" feature of Table and Looper controls, the optional event "Pull to refresh" must be added. This event consists of three different codes:
  • "Pull to refresh: Start": This code is called when the "Pull to refresh" gesture is detected.
  • "Pull to refresh: Wait for release": This code is called when a refresh can be started.
  • "Pull to refresh: Refresh": This code is called when the refresh is started.
AndroidiPhone/iPad

Specific optional event: Application of light/dark theme

If the dark theme is enabled in the project, the optional event "Application of light/dark theme" is available. This event allows you to manage special cases to switch between light and dark theme.
This event is run in the following cases:
  • When loading the internal window, after the "Global declarations" event and before the initialization events of the internal window controls.
  • If the internal window is loaded when changing the theme through programming with ChangeTheme, only if the withCodeExecution constant has been specified.
  • It the internal window is loaded when the system automatically changes the theme: modification of system settings, changing the day/night time, activating/deactivating the battery saver, etc.
For more details, see Dark theme on mobile devices.

Optional event: Start scrolling

Executed when the user starts scrolling an Internal Window control. This event is used to scroll through the content of the control, if necessary.
Reminder: ScrollbarPosition gets the position of the scrollbar.
Remark: This event is available for both Internal Window controls and standard internal windows.

Optional event: While scrolling

Executed when the user scrolls an Internal Window control. This event is used to scroll through the content of the control, if necessary.
Reminder: ScrollbarPosition gets the position of the scrollbar.
Remark: This event is available for both Internal Window controls and standard internal windows.

Optional event: Stop scrolling

Executed when the user stops scrolling an Internal Window control. This event is used to scroll through the content of the control, if necessary.
Reminder: ScrollbarPosition gets the position of the scrollbar.
Remark: This event is available for both Internal Window controls and standard internal windows.
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 07/04/2022

Send a report | Local help