<Dashboard>.MoveWidget (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

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.

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

// Moves the widget 2 to the top of Dashboard control
DASH_MyDashboard.MoveWidget(2, 1, 1)

Syntax

Moving a widget identified by its subscript Hide the details

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

<Dashboard control>: Control name

Name of Dashboard control to use.

<Widget subscript>: Integer

Subscript of widget to use. This subscript 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 dashNoReorganization constant may produce an incorrect display (with overlapping 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:

DASH_TimeZones.MoveWidget(1, 80, 80, dashUnitPixel)
// The widget will be positioned in cell 1 x 1

DASH_TimeZones.MoveWidget(1, 160, 200, dashUnitPixel)
// The widget will be positioned in cell 2 x 2

DASH_TimeZones.MoveWidget(1, 211, 211, dashUnitPixel)
// The widget will be positioned in cell 3 x 3

DASH_TimeZones.MoveWidget(1, 400, 500, dashUnitPixel)
// The widget will be positioned in cell 4 x 5

Component : wd260obj.dll