<Dashboard>.ResizeWidget (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Dashboard functions

Prefix syntax

ResizeWidget

Presentation

Example

Rule used for calculating cells

See also

<Dashboard>.ResizeWidget (Function)

In french: <Tableau de bord>.ChangeTailleWidget

Not available

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

Reminder: A widget corresponds to:

an internal window.

Example

// Places the widget #1 on two columns to display the details
DASH_MyDashboard.ResizeWidget(1, 2, 1)
STC_Details.Visible = True

Syntax

Resizing a widget identified by its index Hide the details

<Dashboard control>.ResizeWidget(<Widget index> , <Width> , <Height> [, <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.

<Width>: Integer

Width of widget in number of cells or in pixels. The minimum size corresponds to a cell. The value in pixels is rounded to correspond to an integer number of cells.

<Height>: Integer

Height of the widget in number of cells or in pixels. The minimum size corresponds to a cell. 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 Resizes 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 for the widget size is a number of cells.
dashUnitPixel The unit used for the widget size 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.ResizeWidget(1, 80, 80, dashUnitPixel)
// the widget will be set to 1 x 1

DASH_TimeZones.ResizeWidget(1, 200, 200, dashUnitPixel)
// the widget will be set to 2 x 2

DASH_TimeZones.ResizeWidget(1, 201, 201, dashUnitPixel)
// the widget will be set to 3 x 3

DASH_TimeZones.ResizeWidget(1, 400, 500, dashUnitPixel)
// the widget will be set to 4 x 5

Component: wd280obj.dll