Height (Property)

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

Height in a report
Height of a row
Initial height (control and window)
Height of controls in a form
Limits

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Height (Property)

In french: Hauteur

..Height is used to find out and modify the height:

of a control or block in a report.
of a control (found in a window), window, row found in a table, in a list box or in a listview, option found in a radio button or in a check box, break header or break footer found in a table or in a looper.
of a control (found in a page), break header or break footer found in a looper. The control can be stackable or not. of a control (found in a page), break header or break footer found in a table or in a looper. The control can be stackable or not.

You also have the ability to find out the height of a table cell.

The modification is available for the "Automatic" or "Dynamic" controls only ("Details" tab of control description).

The modification is available for the "Automatic" or "Dynamic" controls only ("GUI" tab of control description).

Notes:

The border of control or block is included in its height. ..HeightInPixel is used to find out the control height in pixels.
The height of a control is defined in the editor during the control description.

Versions 16 and later

This property is now available for the Windows Phone applications.

New in version 16

This property is now available for the Windows Phone applications.

Versions 15 and later

This property is now available for the Android applications.

New in version 15

This property is now available for the Android applications.

Versions 17 and later

This property is now available for the iPhone/iPad applications.

New in version 17

This property is now available for the iPhone/iPad applications.

Versions 18 and later

This property is now available in Windows Store Apps mode.

New in version 18

This property is now available in Windows Store Apps mode.

Versions 20 and later

This property is now available for the Table controls in the Android applications.

This property is now available for the Table controls and for the table columns in the iPhone/iPad applications.

New in version 20

This property is now available for the Table controls in the Android applications.

This property is now available for the Table controls and for the table columns in the iPhone/iPad applications.

This property is now available for the Table controls in the Android applications.

This property is now available for the Table controls and for the table columns in the 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 height of "EDT_CustomerName"
EDT_CustomerName..Height = EDT_CustomerName..Height + 15
// Is equivalent to: EDT_CustomerName..Height += 15

// Modify the height of a window and control
WIN_CustomerForm..Height += 100 // Adds 100 pixels
EDT_Input1..Height += 10 // Adds 10 pixels

Syntax

Finding out the height of an object Hide the details

<Result> = <Object Name>..Height

<Result>: Real

Height of specified object. This height is expressed in pixels in a window and/or in a page, and in millimeters in a report.

<Object Name>: Character string (with or without quotes)

Name of object (control or block) to use.

Modifying the height of an object Hide the details

<Object Name>..Height = <New Height>

<Object Name>: Character string (with or without quotes)

Name of object (control or block) to use.

<New Height>: Real

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

Remarks

Height in a report

The height of a non-breakable block cannot exceed the available page height (excluding the page header and the page footer).The height of a non-breakable block cannot exceed the available page height (excluding the page header and the page footer).
The height of a page footer cannot be modified. On the contrary, the height of a page header can be modified by programming.The height of a page footer cannot be modified. However, the height of a page header can be modified by programming.
A control must be entirely contained in the block to which it belongs.

Height of a row

The height of each row found in a Table control, List Box control or ListView control can be defined by programming. For the browsing List Box and Table controls, this height is kept for the visible section on the screen only.

Example: Defines the height of row 3 in "LIST_List1" to 200.

LIST_List1[3]..Height = 200

Note: For a table column, ..Height is used to find out the visible height of table column. This property is available in read-only.

Initial height (control and window)

The initial height (described in the editor) is returned by ..InitialHeight.

In most cases, the height of an object depends on ..MaxHeight and ..MinHeight. However, this constraint disappears when the height is modified by programming (when using ..Height or WinSize).

Height of controls in a form

In server code, the returned and modifiable height corresponds to the total height of the control (height of the caption plus height of the input area if the caption and the input area are one above each other).

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

Limits

Limit for the reports
..Height cannot be used on a report or on a Check box control.

Limits for the controls

In Windows 98, the size of elements is limited to ± 32 767.
In Windows NT/2000, it is possible (but not recommended) to specify a size up to ± 2 147 483 647.

..Height only applies to the following elements:

Button.
Static control.
Edit control.
Image.
Check box.
Radio button.
List box.
Combo box.
TreeView.
Tab.
Window.
Table.
Table column.
Supercontrol.

..Height is not available for the table columns.

..Height is not available for the iFrame controls.

..Height is available in read-only for the Site Map Path controls and for the Table controls.