Help / Developing an application or site / Controls, windows and pages / Controls: Available types / Dashboard control
  • Default events
  • Events with procedures
  • Optional events
  • Widget optional events
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WindowsLinuxPHPWEBDEV - Browser code
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Stored procedures
Events associated with a Dashboard control
Default events
WINDEV WINDEV and WINDEV Mobile manage the following events by default (order of appearance in the code editor):
EventRuntime condition
InitializingExecuted when the window is opened. *
Widgets added through programming must be added in this event (DashAddWidget then DashInitialConfiguration).
Adding a widgetRun once a widget was added via the context menu of Dashboard control in edit mode.
Deleting a widgetRun when hiding a widget via the context menu of Dashboard control in edit mode.
  • If this event does not return a value or returns True, the widget will be hidden.
  • If this event returns False, the widget will not be hidden.
Moving a widgetRun once a Widget was moved in the Dashboard control in edit mode.
Resizing a widgetRun once a Widget was resized in the Dashboard control in edit mode.

(*) By default, the "Initializing" event of each control is executed 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 that appears, use the arrows on the right to change the order in which the controls are initialized.
Events with procedures
To simplify the operations performed on widgets in a Dashboard control, several procedures are proposed in each event. These procedures take as parameter the widget variable to use. This variable is a Control variable. The widget can be handled by this variable.
Example: To find tout the Widgets deleted by the user:
PROCÉDURE DeleteWidget(Widget is Control)
Trace("Deletion" + Widget.Caption)
Trace("Deletion" + Widget.SourceWindow)
Optional events
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.
Widget optional events
Widgets are internal windows displayed in a Dashboard control.
In this case, a specific optional event can be associated with the internal window or page: "Refresh widget".
This event is run when DashDisplay is run.
Minimum version required
  • Version 19
This page is also available for…
Click [Add] to post a comment

Last update: 06/10/2022

Send a report | Local help