DashLoadConfiguration (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

DashLoadConfiguration (Function)

In french: TDBChargeConfiguration

Not available

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.

Versions 20 and later

This function is now available in WEBDEV Server.

This function is now available in Browser code.

This function is now available for WEBDEV sites in Linux.

New in version 20

This function is now available in WEBDEV Server.

This function is now available in Browser code.

This function is now available for WEBDEV sites in Linux.

This function is now available in WEBDEV Server.

This function is now available in Browser code.

This function is now available for WEBDEV sites in Linux.

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 know the error details, use ErrorInfo.

<Dashboard control>: Control name

Name of Dashboard control to use.

<Configuration>: Character string (with quotes)

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

Component : wd250obj.dll