Height (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.

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

The Property Height allows to know and modify the height:

of a control or block in a report.
of a control (in a window), window, row of a Table, List Box or ListView control, option of a Radio Button or Check Box control, break header or footer of a Table or Looper control.
of a control (in a page), break header or footer in a Table or Looper control. The control can be overlayable or not.

You can also know the height of a cell in a Table control.

The modification is available for overlayable controls only ("UI" tab of the control description).

Remarks:

The border of control or block is included in its height. HeightInPixel is used to know the control height in pixels.
The height of a control is defined in the editor, in the control description.
To make the content of a maximized window scrollable, use the Property UsefulHeight.

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 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 Table controls in Android applications.

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

New in version 20

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

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

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

This property is now available for Table controls and 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 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 element Hide the details

<Result> = <Element used>.Height

<Result>: Real

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

<Element used>: Name of control or block.

Name of the element (control or block) to use.

Modifying the height of an element Hide the details

<Element used>.Height = <New height>

<Element used>: Name of control or block.

Name of the element (control or block) to use.

<New height>: Real

New height of the specified element. 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 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 in a Table, List Box or ListView control can be defined by programming. For 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

Remark: For a column of an Table control, the Height property allows to know the Visible height of the Table control column . This property is available in read-only mode.

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 changing the height by programming (using Property Height or the WinSize function).

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
The Property Height cannot be used on an report or Check Box control.

The Height property only applies to the following elements:

Button control.
Static control.
Edit control.
Image control.
Check Box control.
Radio Button control.
List Box control.
Combo Box control.
TreeView control.
Tab control.
Window.
Table control.
Column of Table control.
Supercontrol.

The Property Height is not available on the Table control columns.

Height is not available for the iFrame controls.

The Property Height is only available in get on the Navigation Path and Table fields.