<Dashboard>.MoveWidget (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

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

Rule used for calculating cells

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Dashboard>.MoveWidget (Function)

In french: <Tableau de bord>.DéplaceWidget

Not available

Changes the position of a widget found in a Dashboard control. This widget is already configured or displayed.

Reminder: A Widget corresponds to:

an internal window.
an internal page.

Example

// Déplace le Widget 2 en haut du champ Tableau de bord
TDB_MonTableauDeBord.DéplaceWidget(2, 1, 1)

Syntax

Moving a widget identified by its index Hide the details

<Dashboard control>.MoveWidget(<Widget index> , <X> , <Y> [, <Options>])

<Dashboard control>: Control name

Name of the Dashboard control to be used.

<Widget index>: Integer

Index of the widget to use. This index corresponds to:
the addition number of the widget defined in the window editor or in the page editor.
the addition number of widget returned by <Dashboard>.AddWidget.

<X>: Integer

Horizontal position of widget in number of cells or in pixels. The first cell is cell [1, 1]. The value in pixels is rounded to correspond to an integer number of cells.

<Y>: Integer

Vertical position of widget in number of cells or in pixels. The first cell is cell [1, 1]. The value in pixels is rounded to correspond to an integer number of cells.

<Options>: Optional Integer constant

Allows you to define the unit used and the reorganization mode:
dashNoReorganization Moves the widget without reorganizing the adjacent widgets.
Caution: Using the constant tdbSansRéorganisation can lead to incorrect display (with overlaid Widgets). When using this constant, it is important to entirely reorganize the Dashboard control with <Dashboard>.ResizeWidget and <Dashboard>.MoveWidget.
dashUnitCell
(Default value) The unit used when moving the widget is a number of cells.
dashUnitPixel The unit used when moving the widget is the pixel.

Remarks

Rule used for calculating cells

Let's see some examples for a widget whose size is equal to 100 px by 100 px with a margin set to 10 px:

TDB_FuseauxHoraires.DéplaceWidget(1, 80, 80, dashUnitPixel)
// Le Widget se positionnera dans la case 1 x 1

TDB_FuseauxHoraires.DéplaceWidget(1, 160, 200, dashUnitPixel)
// Le Widget se positionnera dans la case 2 x 2

TDB_FuseauxHoraires.DéplaceWidget(1, 211, 211, dashUnitPixel)
// Le Widget se positionnera dans la case 3 x 3

TDB_FuseauxHoraires.DéplaceWidget(1, 400, 500, dashUnitPixel)
// Le Widget se positionnera dans la case 4 x 5

Component: wd300obj.dll