DashAddWidget (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Controls, pages and windows / Dashboard functions

New widget

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

DashAddWidget (Function)

In french: TDBAjouteWidget

Not available

Adds and displays a widget (internal window or page) in a Dashboard control.

Caution: Widgets added programmatically are not automatically displayed. You must use DashInitialConfiguration before the Dashboard control is displayed for the first time.

Example

// Ajout 2 éléments
DashAddWidget(TDB_MonTableauDeBord, FI_Ventes, "Ventes")
DashAddWidget(TDB_MonTableauDeBord, FI_StatMensuelle, "Stats Mensuelles Juillet", "201307")

nIndice is int
// Ajoute un Widget qui attend des paramètres
nIndice = DashAddWidget(TDB_TableauDeBord, FI_Widget_Horloge, "Horloge " + ...
COMBO_AjoutWidget[COMBO_AjoutWidget].ValeurAffichée, ...
COMBO_AjoutWidget[COMBO_AjoutWidget].ValeurAffichée)
// Affiche ce Widget à la demande
IF YesNo(Yes, "Souhaitez-vous afficher ce Widget?") = Yes THEN
TDB_TableauDeBord[nIndice].Visible = True
ELSE
ToastDisplay("Le Widget a été ajouté au tableau de bord en ""caché""." + ...
"Passez en mode édition pour l'ajouter.", ...
toastShort, vaMiddle, haCenter)
END

Syntax

<Result> = DashAddWidget(<Dashboard control> , <Widget> , <Caption> [, <Parameter 1> [... [, <Parameter N>]]])

<Result>: Integer

Index of the added element. This index can be used to handle the widget.

<Dashboard control>: Control name

Name of the Dashboard control to be used.

<Widget>: Name of internal window or internal page

Name of the internal window that must be added into the Dashboard control.

<Caption>: Character string

Widget caption. This caption will be displayed in the context menu of the Dashboard control and it will allow the user to handle the widget.

<Parameter 1>: Type of value sent to the window or page (optional)

First parameter that will be passed to the "Global declarations" event of the internal window or internal page to open. This parameter is passed by reference and it is considered as being a variable global to the internal window or internal page.
Caution: Only the simple types are available.

<Parameter N>: Type of value sent to the window or page (optional)

Nth parameter that will be passed to the "Global declarations" event of the internal window or internal page to open. This parameter is passed by reference and it is considered as being a variable global to the internal window or internal page.
Caution: Only the simple types are available.

Remarks

New widget

The widget is declared in addition to the widgets defined in the description of Dashboard control.

This widget can be made visible:

by using DashInitialConfiguration before the first display.
by the end user via the popup menu.
by using the following syntax:
TDB_NomTableauBord[Indice].Visible = Vrai
where <Index> is the widget number returned by DashAddWidget.

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.

Component: wd280obj.dll