PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • Rule used for calculating cells
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
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/iPad an internal window.
  • WEBDEV - Server codeWEBDEV - Browser code an internal page.
Versions 22 and later
iPhone/iPad This function is now available for iPhone/iPad applications.
Android This function is now available for Android applications.
New in version 22
iPhone/iPad This function is now available for iPhone/iPad applications.
Android This function is now available for Android applications.
iPhone/iPad This function is now available for iPhone/iPad applications.
Android 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:
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 : wd240obj.dll
Minimum version required
  • Version 23
This page is also available for…
Comments
Click [Add] to post a comment