<Dashboard>.Mode (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Disabling options and bar of edit mode
Deleting the Edit mode for the end user (via the AAF)

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Dashboard>.Mode (Function)

In french: <Tableau de bord>.Mode

Not available

Opens or closes the "Edit" mode of Dashboard control.

Versions 20 and later

This function is now available in WEBDEV Server.

This function is now available for WEBDEV sites in Linux.

This function is now available in Browser code.

New in version 20

This function is now available in WEBDEV Server.

This function is now available for WEBDEV sites in Linux.

This function is now available in Browser code.

This function is now available in WEBDEV Server.

This function is now available for WEBDEV sites in Linux.

This function is now available in Browser code.

Versions 22 and later

This function is now available for iPhone/iPad applications.

This function is now available for Android applications.

New in version 22

This function is now available for iPhone/iPad applications.

This function is now available for Android applications.

This function is now available for iPhone/iPad applications.

This function is now available for Android applications.

Example

// Si le champ Tableau de bord est déjà en mode édition, avertit l'utilisateur
SI TDB_TableauDeBord.Mode() <> tdbSansModif ALORS
Erreur("Le tableau de bord est déjà en mode édition")
RETOUR
FIN

nOption est un entier

// Définit l'option d'édition
SI INT_OptionsEdition[1] ALORS nOption += tdbDéplacement
SI INT_OptionsEdition[2] ALORS nOption += tdbRedimensionnement
SI INT_OptionsEdition[3] ALORS nOption += tdbSuppression

// Vérifie qu'une option au moins soit cochée
SI nOption = 0 ALORS
Erreur("Vous devez cocher au moins une option d'édition")
DonneFocusEtRetourUtilisateur(INT_OptionsEdition)
FIN

// Modifie le mode d'édition
TDB_TableauDeBord.Mode(nOption)

// Désactiver la suppression des widgets
// mais pas leur déplacement ou leur redimensionnement:
TDB_SansNom1.Mode(tdbDéplacement + tdbRedimensionnement)
// Attention, pour ne pas afficher du tout la barre d'outils,
// il faut utiliser la fonction DésactiveFAA (ou FAADesactive) avec la constante faaTdbModeEdition.

Syntax

Modifying the mode of Dashboard control Hide the details

<Dashboard control>.Mode(<Mode>)

<Dashboard control>: Control name

Name of the Dashboard control to be used.

<Mode>: Integer constant (or combination of constants)

Edit options available for the user:
dashMove Switch to edit mode: the user can move the widgets in the Dashboard control.
dashResize Switch to edit mode: the user can resize the widgets in the Dashboard control.
dashNoModif Close the edit mode: the user cannot modify the widgets in the Dashboard control.
This constant cannot be combined with the other constants.
dashDelete Switch to edit mode: the user can hide the widgets in the Dashboard control.

Finding out the current mode of Dashboard control Hide the details

<Result> = <Dashboard control>.Mode()

<Result>: Integer constant

Current edit mode of Dashboard control:
dashMove Edit mode: the user can move the widgets in the Dashboard control.
dashResize Edit mode: the user can resize the widgets in the Dashboard control.
dashNoModif Standard mode: the user cannot modify the widgets in the Dashboard control.
dashDelete Edit mode: the user can hide the widgets in the Dashboard control.

<Dashboard control>: Control name

Name of the Dashboard control to be used.

Remarks

Disabling options and bar of edit mode

<Dashboard>.Mode is used to disable some features of the Dashboard control. Deleting these features can have consequences on the bar of edit mode. Thus, if deleting widgets is forbidden, the trash button is not displayed in the toolbar.

Remark: To entirely disable the toolbar display on the Dashboard control, use AAFDisable associated with the aafDashEditMode constant.

Deleting the Edit mode for the end user (via the AAF)

<Dashboard>.Mode is used to switch to edit mode through programming.

To remove the possibility for the user to switch to edit mode (via the popup menu or long click), use the AAFDisable function with the aafDashEditModeconstant.

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: wd270obj.dll