Height (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

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

Help / WLanguage / WLanguage properties / Various properties

Height in a report
Row height
Initial height (control and window)
Height of controls in a form
Limitations

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Height (Property)

In french: Hauteur

The Height property gets and sets 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.
of a break cell in a Table or Looper control.

You can also get 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 the control or block is included in its height. The HeightInPixel property is used to get the height of a control 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 UsefulHeight property.

Example

// Augmente la hauteur du champ "SAI_NomClient"
SAI_NomClient.Hauteur = SAI_NomClient.Hauteur + 15
// Est équivalent à : SAI_NomClient.Hauteur + = 15

// Modification de la hauteur de la fenêtre et d'un champ
FEN_FicheClient.Hauteur += 100	// Ajoute 100 pixels
SAI_Saisie1.Hauteur += 10	// Ajoute 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 programmatically.
A control must be entirely contained in the block to which it belongs.

Row height

The height of each row in a Table, List Box or ListView control can be defined programmatically. In the case of List Box control and Table based on a data file, this height is retained only for the part visible on the screen.

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

LISTE_Liste1[3].Hauteur = 200

Note: For a column in a Table field, the Height property lets you know the visible height of the column in the Table field.. This property is read-only.

Initial height (control and window)

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

In most cases, the height of an object depends on MaxHeight and MinHeight. However, this constraint no longer applies when the height is changed through programming (with the Height property 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.

Limitations

Limitations for reports
The Height property cannot be used on a report or on a Check Box control.

The Height property can only be used with the following elements:

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

The Height property is not available on Table control columns.

The Height property is not available on iFrame controls.

The Height property is only available in read-only mode on Breadcrumb and Table controls.