DashLoadConfiguration (Function)

Restores the configuration of a Dashboard control. This configuration includes the following elements:

position of internal windows or pages in the Dashboard control.
size of internal windows or pages in the Dashboard control.
visibility of internal windows or pages in the Dashboard control.

Remark: To automatically save or restore the user configuration, check "Remember configuration of Widgets" in the "Details" tab of the control description window.

Example

// Get a file that was saved beforehand
IF fFileExist(fWebDir() + ["\"] + "DashConfig.tdb") THEN
sMyConfig = fLoadText(fWebDir() + ["\"] + "DashConfig.tdb")
DashLoadConfiguration(DASH_TimeZones, sMyConfig)
END

Syntax

<Result> = DashLoadConfiguration(<Dashboard control> , <Configuration>)

<Result>: Boolean

True if the configuration was loaded.
False otherwise. To get more details on the error, use ErrorInfo.

<Dashboard control>: Control name

Name of the Dashboard control to be used.

<Configuration>: Character string

Configuration to restore. This configuration is the result of DashSaveConfiguration.
Caution: If the format of this parameter is invalid or if it cannot be applied to the Dashboard control (because the internal windows/pages or the number of columns do not correspond for example), <Result> is set to False.

Remarks

The widgets declared visible since the last backup must be visible when loading the configuration.

Related Examples:

Training (WINDEV): WD Dashboard

[ + ] The "WD Dashboard" example is an educational example for using the Dashboard control.
This example explains how to:
- handle the control in "edit" mode,
- save/load a configuration,
- configure the control (initial configuration, addition/deletion of widgets, ...),
- refresh a widget,
- etc.

Training (WEBDEV): WW_Dashboard

[ + ] The "WD Dashboard" example is an educational example for using the Dashboard control.
This example explains how to:
- handle the control in "edit" mode,
- save/load a configuration,
- configure the control (initial configuration, addition/deletion of widgets, ...),
- refresh a widget.

Component: wd280obj.dll