ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Multiline Zone functions
  • Characteristics of inserted dynamic row
  • Error case
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
<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.
Minimum version required
  • Version 23
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/21/2023

Send a report | Local help