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 / Internal Window control
  • Default events
  • Optional events
  • Overview
  • Specific optional events: Pull to refresh
  • Specific optional Event: Application of the light/dark theme
  • Optional event: Start of dequeue
  • Optional event: During dequeue
  • Optional event: End of dequeue
  • Optional event: Before skin template change
  • Optional event: After skin template change
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Default events
Warning: Do not confuse "Internal Window Field" and "Internal Window": the "Internal Window Field" is a type of field and 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 windowExecuted when the internal window is changed by ChangeSourceWindow. This event is run after the "Global declarations" and "Initialization" 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 windowExecuted 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 initializationExecuted when 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: Re-entering one of the Edit control fields in this code prevents the window from closing.
WINDEVWINDEV Mobile Request for refreshing the display
Enables you to group together the code for updating the window's fields: field content, status (visible, grayed, etc.), label to be updated, 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:
Executed when the cursor enters in the Internal Window control.
ExitOptional event:
Executed 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 can be added. 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.
    Note: Several optional events can be selected.
  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.
Note: If the deactivated code contains WLanguage code, this code is automatically deleted..
For example, you can use the following events:
  • 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 initiated..
  • "Pull to refresh: Refresh": This code is called when the refresh is launched..
AndroidiPhone/iPad

Specific optional Event: Application of the 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.
  • If the internal window is loaded when the system automatically changes theme: changing system parameters, changing day/night time, activating/deactivating battery saver, etc.
For more details, see Dark theme on mobile devices.

Optional event: Start of dequeue

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: The ScrollbarPosition function is used to find out the position of the elevator.
Note: This event is available both for the Internal window field and for internal windows..

Optional event: During dequeue

Executed when the user scrolls an Internal Window control. This event is used to scroll through the content of the control, if necessary.
Reminder: The ScrollbarPosition function is used to find out the position of the elevator.
Note: This event is available both for the Internal window field and for internal windows..

Optional event: End of dequeue

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: The ScrollbarPosition function is used to find out the position of the elevator.
Note: This event is available both for the Internal window field and for internal windows..

Optional event: Before skin template change

Executed before the skin template is changed using function ChangeSkinTemplate.. Allows you to memorize certain style options for fields present in the internal window (for example, in the case of an internal window present in a component)..
Note: This event is only available for internal windows..

Optional event: After skin template change

Executed after the skin template has been changed using function ChangeSkinTemplate.. Enables you, for example, to reapply certain style options to fields present in the internal window (for example, in the case of an internal window present in a component)..
Note: This event is only available for internal windows..
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 11/23/2024

Send a report | Local help