<Multiline Zone>.InsertLine (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Multiline Zone functions

Prefix syntax

InsertLine

Presentation

Example

Characteristics of inserted dynamic row

Error case

See also

<Multiline Zone>.InsertLine (Function)

In french: <Zone multiligne>.InsèreLigne

Inserts a new dynamic row in a Multiline Zone control. This row is added at the position specified in the zone of the dynamic rows.

Example

// Add a network
nRow is int = 4
MZ_Network.InsertLine(nRow)
MZ_Network[nRow].STC_NetworkName = "Network"
MZ_Network[nRow].IMG_Available.Visible = True

Syntax

<Multiline Zone control>.InsertLine(<Position>)

<Multiline Zone control>: Control name

Name of the Multiline Zone control to be used.

<Position>: Integer

Index of row to add.
Index "1" corresponds to the first row of the Multiline Zone control. All rows are numbered (static rows and dynamic rows).
If the Multiline Zone control contains static rows and dynamic rows, the number of static rows must be taken into account.

Remarks

Characteristics of inserted dynamic row

The inserted dynamic row is empty by default.
To customize the row (caption, color, visibility of elements, etc.), the controls must be modified by the following syntax:

<Multiline Zone control>[<Index>].<Control name>.<Property> = <Value>

For example:

MZ_Products.InsertLine(nRow)
MZ_Products[nRow].STC_NameProdRow = stRow.sProdCap
MZ_Products[nRow].STC_NameProdRow.Color = LightBlue
MZ_Products[nRow].EDT_QtyRow = stRow.nQuantity
The inserted row is not selected by default. To select the added row, the value of the subscript must be assigned to the row of the Multiline Zone control.
For example:

MZ_Products.InsertLine(nRow)
MZ_Products = nRow

or

MZ_Products.InsertLine(nRow)
MZ_Products.Value = nRow
When adding the dynamic row, the initialization processes of the controls in the row are run.
The size of the Multiline Zone control is modified to take the inserted row into account: the control is enlarged to the bottom. If controls are located below the Multiline Zone control, they are moved to the bottom. The useful window height is enlarged accordingly: it is possible to scroll through the window with your finger to see the bottom of the Multiline Zone control and the controls that may be located below this zone.

Error case

An error occurs in the following cases:

no dynamic row is defined in the Multiline Zone control.
more than 300 dynamic rows are found in the Multiline Zone control
one of the initialization events of the row controls triggers an error.