• In WINDEV and WINDEV Mobile, it's an internal window.
• Versions 20 and later
  In WEBDEV, it's an internal page.
  New in version 20
  In WEBDEV, it's an internal page.
  In WEBDEV, it's an internal page.

Versions 20 and later

This feature is now available for WEBDEV sites.

This feature is now available for WEBDEV sites in Linux.

This feature is now available in browser code.

New in version 20

This feature is now available for WEBDEV sites.

This feature is now available for WEBDEV sites in Linux.

This feature is now available in browser code.

This feature is now available for WEBDEV sites.

This feature is now available for WEBDEV sites in Linux.

This feature is now available in browser code.

Versions 22 and later

This feature is now available for Android applications.

This feature is now available for iPhone/iPad applications.

New in version 22

This feature is now available for Android applications.

This feature is now available for iPhone/iPad applications.

This feature is now available for Android applications.

This feature is now available for iPhone/iPad applications.

1. On the "Creation" pane, in the "Containers" group, click "Dashboard".
2. Click where the control will be created in the window or page.To view the control characteristics, select "Description" in the popup menu of the control.

Versions 20 and later
Remark: The dimensions of the control are optimized to take up the available space at the specified position. If the control size does not suit you, press Ctrl + Z: the control size will be reset to default.

New in version 20
Remark: The dimensions of the control are optimized to take up the available space at the specified position. If the control size does not suit you, press Ctrl + Z: the control size will be reset to default.

• Variable width of Widgets: In this case, you can define the number of columns found in the Dashboard control as well as the height of cells.
• Variable number of Widgets: In this case, you can define the size of cells (width and height in pixels).
• Fixed width and number of Widgets . In this case, you can define the number of columns and the size of the cells. The "Adapt" buttons are used to adapt the number of columns according to the size of cells (and conversely).
• the margins between the different Widgets displayed in the Dashboard control.

Versions 20 and later

"Details" tab: Position of popup menu
The popup menu of Dashboard control allows the Web user to:

• Switch to edit mode. The edit mode allows the user to change the order of widgets, to modify their size, ... The available options can be configured by DashMode.
• Restore initial configuration.

The popup menu of Dashboard control is opened from a button positioned on the Dashboard control. You can:

• specify the button to use (option "Place the button"). By default, a button is created when creating the Dashboard control. It is possible to use another button found in the page. This button must be associated with the "Open the Dashboard menu" action ("General" tab in the description window of button). If the "None" button is selected, the popup menu will not be proposed.
  Remark: If you don't want to propose the popup menu by programming, it can be made invisible by ..Visible.
• specify the position of the button that will open the popup menu (option "at position"). This button can be positioned at the top left, top right, bottom left or bottom right of Dashboard control.

New in version 20

"Details" tab: Position of popup menu
The popup menu of Dashboard control allows the Web user to:

• Switch to edit mode. The edit mode allows the user to change the order of widgets, to modify their size, ... The available options can be configured by DashMode.
• Restore initial configuration.

The popup menu of Dashboard control is opened from a button positioned on the Dashboard control. You can:

• specify the button to use (option "Place the button"). By default, a button is created when creating the Dashboard control. It is possible to use another button found in the page. This button must be associated with the "Open the Dashboard menu" action ("General" tab in the description window of button). If the "None" button is selected, the popup menu will not be proposed.
  Remark: If you don't want to propose the popup menu by programming, it can be made invisible by ..Visible.
• specify the position of the button that will open the popup menu (option "at position"). This button can be positioned at the top left, top right, bottom left or bottom right of Dashboard control.

"Details" tab: Position of popup menu
The popup menu of Dashboard control allows the Web user to:

• Switch to edit mode. The edit mode allows the user to change the order of widgets, to modify their size, ... The available options can be configured by DashMode.
• Restore initial configuration.

The popup menu of Dashboard control is opened from a button positioned on the Dashboard control. You can:

• specify the button to use (option "Place the button"). By default, a button is created when creating the Dashboard control. It is possible to use another button found in the page. This button must be associated with the "Open the Dashboard menu" action ("General" tab in the description window of button). If the "None" button is selected, the popup menu will not be proposed.
  Remark: If you don't want to propose the popup menu by programming, it can be made invisible by ..Visible.
• specify the position of the button that will open the popup menu (option "at position"). This button can be positioned at the top left, top right, bottom left or bottom right of Dashboard control.

"Details" tab: Modification by the user
These are the options in the Dashboard control:

• Compact Widgets: This option is used to automatically reorganize the widgets in the Dashboard control when a widget is deleted by the end user.
• Remember configuration of Widgets: This option is used to automatically save the configuration of the Dashboard control performed by the user when closing the window or page. This configuration will be automatically re-displayed during the next opening of window (or page).
  Remark: The user can configure his Dashboard via the popup menu of AAFs (Automatic Application Features). See AAF of Dashboard control for more details.
• Permanent edit mode: This option is used to propose the Dashboard control in edit mode directly during its display. The user will be able to move, resize or hide the widgets directly.

• an internal window.
• Versions 20 and later
  an internal page.
  New in version 20
  an internal page.
  an internal page.

• Add a widget to a Dashboard control.
• Define or modify the display options of a widget.

Add a widget to a Dashboard control

1. In the "Content" tab of control description, click the "Add" button.
2. In the window that is displayed:
   • select the internal windows that will be added as widget and validate.
   • Versions 20 and later
     select the internal pages that will be added as widget and validate.
     New in version 20
     select the internal pages that will be added as widget and validate.
     select the internal pages that will be added as widget and validate.
   Remark: Only the internal windows or pages without parameter can be added into the Dashboard control in the editor. To add an internal window or an internal page with parameters, the additions must be performed by programming with DashAddWidget.
3. The internal windows or pages appear in the list of widgets displayed in the Dashboard control. The display options can be defined for each widget. These options correspond to the initial display of widget.

• The order of widgets in list has no influence on the widget position in the Dashboard control. This position can be defined in the widget description.
• The number associated with the widget is used to handle it by programming.
• To modify the background color of your widget, use a cell in your window or internal page. This cell will contain the controls of your window or internal page. The background of cell will be used to color the widget.

Define or modify the display options of a widget

1. Select the Widget to configure in the "Content" tab of the description window of Dashboard control.
2. In the right section of the screen, specify:
   • the associated internal window or page if necessary.
   • whether the Widget must be visible by default. If the Widget is invisible, a logo is displayed beside the Widget name in the list. the user can make it visible via the popup menu.
   • the initial size and position of the Widget. This position and this size are expressed in cells. The number of cells was defined in the "Details" tab of the description window of control. If the position or the size is modified for a Widget, the position of the next widgets is automatically updated.
     Remark: The maximum widget size corresponds to the maximum size of the internal window associated with the widget. For example, if the maximum widget size is set to two cells of 150 pixels in width and one cell of 150 pixels in height, the maximum size of the corresponding internal window must be set to 300 pixels x 150 pixels.
   • the widget caption. This caption is important: it will appear in the popup menu (AAF) to allow the user to display the widget.

Defining the size of cells

1. Select the Dashboard control.
2. A border is displayed around the cells found in the Dashboard control.
3. The first cell proposes sizing handles.
   • Position the mouse cursor on one of the widget sides. The mouse cursor turns into an arrow.
   • Press the mouse button and move the mouse while keeping the mouse button down until the requested size.
   • The new size applies to all the cells of the Dashboard control.

Defining the size and position of Widgets

1. Select the Dashboard control.
2. Switch to edit mode by using one of the following methods:
   • Click the Dashboard control.
   • Select "Edit the size and position of Widgets" from the popup menu of control.
3. A yellow border appears around the control. You can:
   • Resize the Widgets found in the Dashboard control:
     • Position the mouse cursor on one of the widget sides. The mouse cursor turns into an arrow.
     • Press the mouse button and move the mouse while keeping the mouse button down until the requested size.
   • Move the Widgets found in the Dashboard control:
     • Click the Widget.
     • Move the Widget while keeping the mouse button down.
4. To exit from the edit mode, use one of the following methods:
   • Press the Esc key on the keyboard.
   • Select "End the edit" from the popup menu of the control.
   • Click the window or page.