Width (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

This content has been translated automatically. Click here to view the French version.

Width of a window: Specific features
Initial width (control and window)
Column width
Width of controls in a form
Limits

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Width (Property)

In french: Largeur

Width is used to find out and modify the width:

of a control or block in a report.
of a control (found in a window), window, column found in a table or column found in a list box (including listview).
of a control (found in a page), column found in a table or column found in a list box. The control can be overlayable or not.

This property also allows you to find out the width of a table cell. To modify its width, modify the width of the corresponding column.

Remarks:

In a report, the border of the control or block is included in its width. WidthInPixel is used to find out the width of a report control in pixels.
The width of a control is defined in the editor in the control description.

Versions 15 and later

This property is now available for Android applications.

New in version 15

This property is now available for Android applications.

Versions 17 and later

This property is now available for iPhone/iPad applications.

New in version 17

This property is now available for iPhone/iPad applications.

Versions 18 and later

This property is now available for report controls and blocks in iPhone/iPad applications.

New in version 18

This property is now available for report controls and blocks in iPhone/iPad applications.

Versions 20 and later

This property is now available for Table controls and table columns in Android applications.

This property is now available for table columns in iPhone/iPad applications.

New in version 20

This property is now available for Table controls and table columns in Android applications.

This property is now available for table columns in iPhone/iPad applications.

This property is now available for Table controls and table columns in Android applications.

This property is now available for table columns in iPhone/iPad applications.

Versions 21 and later

This property is now available in Apple Watch mode.

This property is now available in Universal Windows 10 App mode.

New in version 21

This property is now available in Apple Watch mode.

This property is now available in Universal Windows 10 App mode.

This property is now available in Apple Watch mode.

This property is now available in Universal Windows 10 App mode.

Example

// Increases the width of "EDT_CustomerName"
EDT_CustomerName.Width = EDT_CustomerName.Width + 15
// Is equivalent to: EDT_CustomerName.Width += 15

// Modify the width of two controls
EDT_CustomerLastName.Width += 100 // Adds 100 pixels
EDT_CustomerFirstName.Width += 10 // Adds 10 pixels

Syntax

Finding out the width of an element Hide the details

<Result> = <Element used>.Width

<Result>: Real

Width of the specified element. This width is expressed in pixels in a window and/or in a page, and in millimeters in a report.

<Element used>: Type of element

Name of the element (control, window, block, ...) to use.

Modifying the width of an element Hide the details

<Element used>.Width = <New width>

<Element used>: Type of element

Name of the element (control, window, block, ...) to use.

<New width>: Real

New width for the specified element. This width is expressed in pixels in a window and/or in a page, and in millimeters in a report.

Remarks

Width of a window: Specific features

The width of a window takes into account the shadow effect defined in the Windows theme.
The width of a window can be different depending on the events in which the Property Width is used.. This is because the window is resized by the system between the reporting and initialisation events, resulting in a potential difference in value of:
- in the "Global Declarations" event, the window is not yet Visible and therefore has not received its size according to the aircraft. The property returns the initial width (edit width) of the window.
- in the "Initialization" event, the window is Visible on the screen and the anchors, size modifications are applied. Therefore, the window width can be different.
- The actual width of a window is therefore only known in the "Initialization" event of the window..

Initial width (control and window)

The initial width (defined in the editor) is returned by InitialWidth.

In most cases, the width of an element depends on MaxWidth and MinWidth. Nevertheless, this constraint disappears when the width is modified by programming (using the Property Width or the WinSize function).

Column width

When the width of a column is modified in a Table control, if the specified width is less than the minimum width, the latter must be modified (MinWidth) in order to apply the modification.

Horizontal Table control: The Property Width changes the height of the row. Height is used to find out the width of the entire table. This property is available in read-only mode.

Width of controls in a form

In server code, the returned and modifiable width corresponds to the total height of the control (width of caption plus width of input area).

In browser code, the returned and modifiable width corresponds to the width of the input area.

Limits

The Property Width cannot be used on an report.

Width is available in modification for the following controls:

Button.
Image.
Clickable image.
Java applet.
Chart.
Table column.

Width is not available for the iFrame controls.

The Property Width applies only to the following items:

Button.
Libellé.
Edit control.
Image.
Check Box.
Radio Button.
List Box.
Combo Box.
TreeView.
Tab.
Window.
Table.
Table column.
Supercontrol.

The Property Width is not available on the fields Table. However, it is available for table columns.