Dashboard control events

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

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 / Dashboard control

Default events
Events with procedures
Optional events
Widget optional events

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Dashboard control events

Default events

The following events appear by default in the WINDEV and WINDEV Mobile code editor:

Event	Runtime condition

Initializing	Executed when the window is opened. * Widgets added through programming must be added in this event (DashAddWidget then DashInitialConfiguration).
Adding a widget	Run once a widget was added via the context menu of Dashboard control in edit mode.
Deleting a widget	Executed 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 widget	Run once a widget was moved in the Dashboard control in edit mode.
Resizing a widget	Run once a widget was resized in the Dashboard control in edit mode.

(*) By default, the "Initialization" event of each control is executed according to the order in which the controls were created in the window. To modify this runtime order:

On the "Window" tab, in the "Order" group, click "Initialization".
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 out which Widgets have been deleted by the user:

PROCEDURE DeleteWidget(Widget is Control)
Trace("Deletion" + Widget.Caption)
Trace("Deletion" + Widget.SourceWindow)

Optional events

Several optional events can be added. To add an optional event:

Select the desired control.
Display the code window of this control (F2 key).
Click the link "Add other events to xxx" at the bottom of the window code, after the last event.
All the optional events available for the control are displayed.
Check the optional event to add and validate.
Note: Several optional events can be selected.
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.

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: "Widget refresh"..

This event is executed when DashDisplay is run.