DashResizeWidget (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

DashResizeWidget (Function)

In french: TDBChangeTailleWidget

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.
an internal page.

Example

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

Syntax

Resizing the current widget Hide the details

DashResizeWidget(<Width> , <Height> [, <Options>])

<Width>: Integer

Width of current 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.
The widget used corresponds to the control to which the current event belongs (Widget or control belonging to the widget).

<Height>: Integer

Height of current 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.
The widget used corresponds to the control to which the current event belongs (Widget or control belonging to the widget).

<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 DashResizeWidget and DashMoveWidget.
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.

Resizing a widget identified by its index Hide the details

DashResizeWidget(<Dashboard control> , <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 DashAddWidget.

<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 DashResizeWidget and DashMoveWidget.
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:

DashResizeWidget(DASH_TimeZones, 1, 80, 80, dashUnitPixel)
// the widget will be set to 1 x 1

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

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

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

Component: wd300obj.dll