PC SOFT

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • Overview
  • AAFs in the Windows applications
  • Overview
  • The features of popup menu
  • The Edit/Modification mode of Dashboard control
  • AAF in the WEBDEV sites
  • AAFs in the Mobile applications
  • Switching to modification mode
  • Toolbar of modification mode
  • Exit from modification mode
  • Moving a Widget
  • Resizing a Widget
  • Adding a widget
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Dashboard control: Automatic Application Features (AAF)
Overview
The Dashboard control proposes several Automatic Application Features (AAF) allowing the user to benefit from all control capabilities. These features are available for the Windows applications, the WEBDEV sites and the Mobile applications.
Versions 22 and later
Android This feature is now available for the Android applications.
iPhone/iPad This feature is now available for the iPhone/iPad applications.
New in version 22
Android This feature is now available for the Android applications.
iPhone/iPad This feature is now available for the iPhone/iPad applications.
Android This feature is now available for the Android applications.
iPhone/iPad This feature is now available for the iPhone/iPad applications.
WINDEV
AAFs in the Windows applications

Overview

By default, the Dashboard control proposes to the user to:
  • Switch to edit mode: the edit mode allows the user to configure his dashboard. Switch to modification mode: the modification mode allows the user to configure his dashboard.
  • Save the content of Dashboard control in image format.
When the user switches to "edit" mode, he can configure the different elements found in his dashboard: When the user switches to "modification" mode, he can configure the different elements found in his dashboard:
You can:
  • hide an element,
  • add an invisible element,
  • restore the initial configuration.
The edit mode can also be used to modify the position and size of elements.

The features of popup menu

  • Save as (image): This feature is used to save the content of Dashboard control in image format (to print it for example).
  • Switch to edit mode: This feature is used to switch to edit mode in order for the user to configure his dashboard. Switch to modification mode: This feature is used to switch to modification mode in order for the user to configure his dashboard.

The Edit/Modification mode of Dashboard control

The following options are available in the popup menu in modification mode:
  • Add: This option opens a sub-menu that displays the list of Widgets made invisible and that can be added.
  • Hide: This option is used to hide the current Widget.
  • Restore the initial configuration: This option is used to restore the dashboard to its previous status (before the modifications performed in edit mode). All the modifications performed (size, position, hiding, addition) are canceled.
The Edit mode can be configured by programming:
  • DashMode is used to:
    • find out whether the Edit mode is enabled or not,
    • enable ot disable the edit mode,
    • configure the available actions in the edit mode. You can for example allow the Widgets to be moved and resized only.
  • DisableAAF associated with the aafDashEditMode constant allows you to disable the popup menu used to switch to edit mode. AAFDisable (or DisableAAF) associated with the aafDashEditMode constant allows you to disable the popup menu used to switch to edit mode.
The Modification mode can be configured by programming:
  • DashMode is used to:
    • find out whether the Modification mode is enabled or not,
    • enable ot disable the modification mode,
    • configure the available actions in modification mode. You can for example allow the Widgets to be moved and resized only.
  • AAFDisable (or DisableAAF) associated with the aafDashEditMode constant allows you to disable the popup menu used to switch to modification mode.
Versions 20 and later
WEBDEV - Server code
AAF in the WEBDEV sites
By default, the Dashboard control proposes to the user a popup menu used to :
  • Switch to edit mode: This feature is used to switch to edit mode in order for the user to configure his dashboard.
  • Restore the initial configuration: This option is used to restore the dashboard to its previous status (before the modifications performed in edit mode). All the modifications performed (size, position, hiding, addition) are canceled.
  • Display (or not) the different Widgets: All you have to do is check or uncheck the name of Widget to display.
When the user switches to "edit" mode, he can modify the position and size of the elements found in his dashboard. The Edit mode can be configured by programming:
  • DashMode is used to:
    • find out whether the Edit mode is enabled or not,
    • enable ot disable the edit mode,
    • configure the available actions in the edit mode. You can for example allow the Widgets to be moved and resized only.
By default, the Dashboard control proposes to the user a popup menu used to :
  • Switch to modification mode: This feature is used to switch to Modification mode in order for the user to configure his dashboard.
  • Restore the initial configuration: This option is used to restore the dashboard to its previous status (before the modifications performed in modification mode). All the modifications performed (size, position, hiding, addition) are canceled.
  • Display (or not) the different Widgets: All you have to do is check or uncheck the name of Widget to display.
When the user switches to "modification" mode, he can modify the position and size of the elements found in his dashboard. The Modification mode can be configured by programming:
  • DashMode is used to:
    • find out whether the Modification mode is enabled or not,
    • enable ot disable the Modification mode,
    • configure the available actions in Modification mode. You can for example allow the Widgets to be moved and resized only.
New in version 20
WEBDEV - Server code
AAF in the WEBDEV sites
By default, the Dashboard control proposes to the user a popup menu used to :
  • Switch to edit mode: This feature is used to switch to edit mode in order for the user to configure his dashboard.
  • Restore the initial configuration: This option is used to restore the dashboard to its previous status (before the modifications performed in edit mode). All the modifications performed (size, position, hiding, addition) are canceled.
  • Display (or not) the different Widgets: All you have to do is check or uncheck the name of Widget to display.
When the user switches to "edit" mode, he can modify the position and size of the elements found in his dashboard. The Edit mode can be configured by programming:
  • DashMode is used to:
    • find out whether the Edit mode is enabled or not,
    • enable ot disable the edit mode,
    • configure the available actions in the edit mode. You can for example allow the Widgets to be moved and resized only.
By default, the Dashboard control proposes to the user a popup menu used to :
  • Switch to modification mode: This feature is used to switch to Modification mode in order for the user to configure his dashboard.
  • Restore the initial configuration: This option is used to restore the dashboard to its previous status (before the modifications performed in modification mode). All the modifications performed (size, position, hiding, addition) are canceled.
  • Display (or not) the different Widgets: All you have to do is check or uncheck the name of Widget to display.
When the user switches to "modification" mode, he can modify the position and size of the elements found in his dashboard. The Modification mode can be configured by programming:
  • DashMode is used to:
    • find out whether the Modification mode is enabled or not,
    • enable ot disable the Modification mode,
    • configure the available actions in Modification mode. You can for example allow the Widgets to be moved and resized only.
WEBDEV - Server code
AAF in the WEBDEV sites
By default, the Dashboard control proposes to the user a popup menu used to :
  • Switch to edit mode: This feature is used to switch to edit mode in order for the user to configure his dashboard.
  • Restore the initial configuration: This option is used to restore the dashboard to its previous status (before the modifications performed in edit mode). All the modifications performed (size, position, hiding, addition) are canceled.
  • Display (or not) the different Widgets: All you have to do is check or uncheck the name of Widget to display.
When the user switches to "edit" mode, he can modify the position and size of the elements found in his dashboard. The Edit mode can be configured by programming:
  • DashMode is used to:
    • find out whether the Edit mode is enabled or not,
    • enable ot disable the edit mode,
    • configure the available actions in the edit mode. You can for example allow the Widgets to be moved and resized only.
By default, the Dashboard control proposes to the user a popup menu used to :
  • Switch to modification mode: This feature is used to switch to Modification mode in order for the user to configure his dashboard.
  • Restore the initial configuration: This option is used to restore the dashboard to its previous status (before the modifications performed in modification mode). All the modifications performed (size, position, hiding, addition) are canceled.
  • Display (or not) the different Widgets: All you have to do is check or uncheck the name of Widget to display.
When the user switches to "modification" mode, he can modify the position and size of the elements found in his dashboard. The Modification mode can be configured by programming:
  • DashMode is used to:
    • find out whether the Modification mode is enabled or not,
    • enable ot disable the Modification mode,
    • configure the available actions in Modification mode. You can for example allow the Widgets to be moved and resized only.
Versions 22 and later
AndroidiPhone/iPad
AAFs in the Mobile applications

Switching to modification mode

To enter in edit mode in a Dashboard control, a long press must be performed on the control background or on a Widget. A micro vibration is triggered (haptic feedback).
If the long press is performed on a Widget, the Widget is selected: sizing handles are displayed on the four sides of the Widget.
Caution: If the long press is performed on a control found inside a Widget and if this control intercepts the long press (code in the long press process, displaying a popup menu, etc.), the Dashboard control will not switch to edit mode.
In modification mode:
  • Selecting a Widget is performed via a simple click on the Widget.
  • The controls displayed in the Widgets no longer receive the click events and they can not take focus anymore.
  • If at least one Widget is displayed on the last dashboard row, an additional row is added in edit mode (with activation of the vertical scrollbar if necessary). This row is used to add new Widgets or to move existing Widgets.
  • A specific toolbar is displayed. See Toolbar of modification mode for more details.
  • You can:
Remark: DashMode is used to:
  • switch to "modification" mode by programming. To prevent the user from switching to edit mode (the long click performs no action anymore), use AAFDisable (or DisableAAF) associated with the aafDashEditMode constant.
  • disable some features of the Dashboard control (as well as in the bar of modification mode).

Toolbar of modification mode

When the Dashboard control switches to edit mode, a toolbar is displayed in the lower section of control. This toolbar is displayed in semi-transparency above the dashboard Widgets.
This toolbar includes three buttons:
  • "Reinitialize" button : used to restore the initial configuration of the dashboard
  • "OK" button : used to exit from modification mode.
  • Bin button : is used to hide the selected Widget via a click. You also have the ability to perform a Drag and Drop of a Widget on the button in order to hide this Widget (a micro vibration is performed when hovering the bin with the Widget to hide).
Remark: The text color and the bar can be configured in the style of Dashboard control. The color of the icon for the bin button corresponds to the text color.
Remark: If DashMode forbids the deletion of Widgets, the bin button is not displayed in the toolbar.

Exit from modification mode

Several methods can be used to exit from modification mode of Dashboard control :
  • Click the background of Dashboard control.
  • Click the OK button displayed in the toolbar of modification mode.
  • Android Press the "back" key of the phone.

Moving a Widget

To move a Widget:
  • If the Widget is not selected: perform a long press on the Widget. A ghost view of the Widget to move is automatically created.
  • If the Widget is selected: all you have to do is press the pointer on the selected Widget. A ghost view of the Widget to move is automatically created.
During the move, the sizing handles of selected Widget are not drawn.
When the Widget is moved onto a cell containing another Widget, the second Widget is moved onto the first free location and it goes back to its initial location as soon as the moved Widget does not hover it anymore. The move of hovered Widgets is performed with an animation.

Resizing a Widget

To resize a Widget, you must:
  • keep the pointer down on one of the Widget borders (the one that displays the sizing handles).
  • and move the pointer in the requested direction.
A Widget cannot be resized horizontally and vertically at the same time.
During the resize operation, only the handle found on the border on which the pointer was pressed down is displayed.
The Widgets that occupy the cells on which the Widget is enlarged are automatically moved with an animation onto the first free location. They go back to their initial location if the Widget is reduced.

Adding a widget

In modification mode, a "+" sign is displayed in the middle of empty cells (with the same color as the border of Widgets in modification mode).
A click on an empty cell displays a popup menu with the list of Widgets to add.
If all the dashboard Widgets are displayed, the "+" sign is not displayed and a click on an empty cell allows you to exit from modification mode.
Remark: When moving and resizing a Widget, the "+" sign is not drawn in the empty cells.
New in version 22
AndroidiPhone/iPad
AAFs in the Mobile applications

Switching to modification mode

To enter in edit mode in a Dashboard control, a long press must be performed on the control background or on a Widget. A micro vibration is triggered (haptic feedback).
If the long press is performed on a Widget, the Widget is selected: sizing handles are displayed on the four sides of the Widget.
Caution: If the long press is performed on a control found inside a Widget and if this control intercepts the long press (code in the long press process, displaying a popup menu, etc.), the Dashboard control will not switch to edit mode.
In modification mode:
  • Selecting a Widget is performed via a simple click on the Widget.
  • The controls displayed in the Widgets no longer receive the click events and they can not take focus anymore.
  • If at least one Widget is displayed on the last dashboard row, an additional row is added in edit mode (with activation of the vertical scrollbar if necessary). This row is used to add new Widgets or to move existing Widgets.
  • A specific toolbar is displayed. See Toolbar of modification mode for more details.
  • You can:
Remark: DashMode is used to:
  • switch to "modification" mode by programming. To prevent the user from switching to edit mode (the long click performs no action anymore), use AAFDisable (or DisableAAF) associated with the aafDashEditMode constant.
  • disable some features of the Dashboard control (as well as in the bar of modification mode).

Toolbar of modification mode

When the Dashboard control switches to edit mode, a toolbar is displayed in the lower section of control. This toolbar is displayed in semi-transparency above the dashboard Widgets.
This toolbar includes three buttons:
  • "Reinitialize" button : used to restore the initial configuration of the dashboard
  • "OK" button : used to exit from modification mode.
  • Bin button : is used to hide the selected Widget via a click. You also have the ability to perform a Drag and Drop of a Widget on the button in order to hide this Widget (a micro vibration is performed when hovering the bin with the Widget to hide).
Remark: The text color and the bar can be configured in the style of Dashboard control. The color of the icon for the bin button corresponds to the text color.
Remark: If DashMode forbids the deletion of Widgets, the bin button is not displayed in the toolbar.

Exit from modification mode

Several methods can be used to exit from modification mode of Dashboard control :
  • Click the background of Dashboard control.
  • Click the OK button displayed in the toolbar of modification mode.
  • Android Press the "back" key of the phone.

Moving a Widget

To move a Widget:
  • If the Widget is not selected: perform a long press on the Widget. A ghost view of the Widget to move is automatically created.
  • If the Widget is selected: all you have to do is press the pointer on the selected Widget. A ghost view of the Widget to move is automatically created.
During the move, the sizing handles of selected Widget are not drawn.
When the Widget is moved onto a cell containing another Widget, the second Widget is moved onto the first free location and it goes back to its initial location as soon as the moved Widget does not hover it anymore. The move of hovered Widgets is performed with an animation.

Resizing a Widget

To resize a Widget, you must:
  • keep the pointer down on one of the Widget borders (the one that displays the sizing handles).
  • and move the pointer in the requested direction.
A Widget cannot be resized horizontally and vertically at the same time.
During the resize operation, only the handle found on the border on which the pointer was pressed down is displayed.
The Widgets that occupy the cells on which the Widget is enlarged are automatically moved with an animation onto the first free location. They go back to their initial location if the Widget is reduced.

Adding a widget

In modification mode, a "+" sign is displayed in the middle of empty cells (with the same color as the border of Widgets in modification mode).
A click on an empty cell displays a popup menu with the list of Widgets to add.
If all the dashboard Widgets are displayed, the "+" sign is not displayed and a click on an empty cell allows you to exit from modification mode.
Remark: When moving and resizing a Widget, the "+" sign is not drawn in the empty cells.
AndroidiPhone/iPad
AAFs in the Mobile applications

Switching to modification mode

To enter in edit mode in a Dashboard control, a long press must be performed on the control background or on a Widget. A micro vibration is triggered (haptic feedback).
If the long press is performed on a Widget, the Widget is selected: sizing handles are displayed on the four sides of the Widget.
Caution: If the long press is performed on a control found inside a Widget and if this control intercepts the long press (code in the long press process, displaying a popup menu, etc.), the Dashboard control will not switch to edit mode.
In modification mode:
  • Selecting a Widget is performed via a simple click on the Widget.
  • The controls displayed in the Widgets no longer receive the click events and they can not take focus anymore.
  • If at least one Widget is displayed on the last dashboard row, an additional row is added in edit mode (with activation of the vertical scrollbar if necessary). This row is used to add new Widgets or to move existing Widgets.
  • A specific toolbar is displayed. See Toolbar of modification mode for more details.
  • You can:
Remark: DashMode is used to:
  • switch to "modification" mode by programming. To prevent the user from switching to edit mode (the long click performs no action anymore), use AAFDisable (or DisableAAF) associated with the aafDashEditMode constant.
  • disable some features of the Dashboard control (as well as in the bar of modification mode).

Toolbar of modification mode

When the Dashboard control switches to edit mode, a toolbar is displayed in the lower section of control. This toolbar is displayed in semi-transparency above the dashboard Widgets.
This toolbar includes three buttons:
  • "Reinitialize" button : used to restore the initial configuration of the dashboard
  • "OK" button : used to exit from modification mode.
  • Bin button : is used to hide the selected Widget via a click. You also have the ability to perform a Drag and Drop of a Widget on the button in order to hide this Widget (a micro vibration is performed when hovering the bin with the Widget to hide).
Remark: The text color and the bar can be configured in the style of Dashboard control. The color of the icon for the bin button corresponds to the text color.
Remark: If DashMode forbids the deletion of Widgets, the bin button is not displayed in the toolbar.

Exit from modification mode

Several methods can be used to exit from modification mode of Dashboard control :
  • Click the background of Dashboard control.
  • Click the OK button displayed in the toolbar of modification mode.
  • Android Press the "back" key of the phone.

Moving a Widget

To move a Widget:
  • If the Widget is not selected: perform a long press on the Widget. A ghost view of the Widget to move is automatically created.
  • If the Widget is selected: all you have to do is press the pointer on the selected Widget. A ghost view of the Widget to move is automatically created.
During the move, the sizing handles of selected Widget are not drawn.
When the Widget is moved onto a cell containing another Widget, the second Widget is moved onto the first free location and it goes back to its initial location as soon as the moved Widget does not hover it anymore. The move of hovered Widgets is performed with an animation.

Resizing a Widget

To resize a Widget, you must:
  • keep the pointer down on one of the Widget borders (the one that displays the sizing handles).
  • and move the pointer in the requested direction.
A Widget cannot be resized horizontally and vertically at the same time.
During the resize operation, only the handle found on the border on which the pointer was pressed down is displayed.
The Widgets that occupy the cells on which the Widget is enlarged are automatically moved with an animation onto the first free location. They go back to their initial location if the Widget is reduced.

Adding a widget

In modification mode, a "+" sign is displayed in the middle of empty cells (with the same color as the border of Widgets in modification mode).
A click on an empty cell displays a popup menu with the list of Widgets to add.
If all the dashboard Widgets are displayed, the "+" sign is not displayed and a click on an empty cell allows you to exit from modification mode.
Remark: When moving and resizing a Widget, the "+" sign is not drawn in the empty cells.
See also
Minimum version required
  • Version 19
This page is also available for…
Comments
Click [Add] to post a comment