ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Dashboard functions
  • Rule used for calculating cells
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Changes the position of a widget found in a Dashboard control. This widget is already configured or displayed.
Reminder: A widget corresponds to:
  • WINDEVAndroidiPhone/iPadMac Catalyst an internal window.
  • WEBDEV - Server codeWEBDEV - Browser code an internal page.
Example
// Moves the widget 2 to the top of Dashboard control
DASH_MyDashboard.MoveWidget(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:
dashNoReorganizationMoves 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.
dashUnitPixelThe 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: wd290obj.dll
Minimum version required
  • Version 23
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/21/2023

Send a report | Local help