ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / Developing an application or website / Controls, windows and pages / Controls: Available types / Multiline Zone control
  • Multiline Zone control overview
  • Creating a Multiline Zone control
  • Characteristics of the Multiline Zone control
  • Row description
  • Style of the Multiline Zone control
  • Static use of the Multiline Zone control
  • Dynamic use of a Multiline Zone control
  • Status of the Multiline Zone control
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 control overview
The Multiline Zone control allows you to easily create interfaces in iOS style. For example:
This control is used to group multiple controls:
  • options of a category,
  • information about a contact, etc
  • ...
This control can contain at the same time:
  • rows defined in edit mode (static rows).
  • rows defined at runtime, through programming (dynamic rows).
Creating a Multiline Zone control
To create a Multiline Zone control:
  1. On the "Creation" tab, in the "Data" group:
    • WINDEV Mobile click "Multiline zone".
    • WINDEV expand "Looper" and click "Multiline zone".
  2. Click at the desired location to create the control.
Remarks:
  • iPhone/iPad The window creation wizard for iPhone and iPad also allows you to create preset Multiline Zone controls. For more details, see Windows for iPhone and iPad.
  • WINDEV Mobile The dimensions of the control are optimized to take up the available space at the specified position. If the control size does not suit you, press Ctrl + Z: the control size will be reset to default.
By default, the created control contains a single empty "static" row. This control is customized in its description window.
To view the characteristics of the control, select "Description" in the context menu.
Characteristics of the Multiline Zone control

Row description

The "General" tab in the description window of a multiline zone is used to:
  • define the parameters of the current row,
  • add a new row,
  • duplicate an existing row,
  • delete an existing row.
When a new row is added ("New row") or the current row is modified ("Modify type of row" or double-click on the row), a wizard starts, allowing you to create default content corresponding to the most common use cases:
  • a check box button,
  • a caption with a sub-caption directing to a list of choices, ...
When validating the description window, the Multiline zone control is updated with the selected rows.
The controls corresponding to the selected row options are automatically created.

Style of the Multiline Zone control

The "Style" tab of the Multiline Zone control description window is used to configure the characteristics:
  • of the control caption.
  • of the outside border.
  • of the inside border.
  • of the selected row.

Static use of the Multiline Zone control

A Multiline Zone control is static if the "Define as the repeated row of the control" option ("General" tab) is not checked for any of the rows.
In this case, the Multiline Zone control is used to simplify the interface by grouping the elements by "theme".
For example, a static Multiline Zone control will be used in a form to enter the first and last names of a contact, their address, ...
In this case, the content will be static and the number of rows will be fixed. For example, for the identity:
  • a row for the company,
  • a row for the last name,
  • a row for the first name.
In this case, the controls in each row are linked to the corresponding item in the customers data file.
Another example: using a static Multiline Zone control to behave like a radio button:

Dynamic use of a Multiline Zone control

A Multiline Zone control is dynamic if the "Define as the repeated row of the control" option ("General" tab) is checked for any of the rows. This option can be checked for a single row only.
In this case, rows can be added through programming (for example, a list of options or a list of possible values according to a choice or to a database).
For example:
Here, the first row is static and the rows of products correspond to a dynamic row in the editor.
A line can be added by mlzAddLine. For more details on the functions for handling dynamic Multiline Zone controls, see Multiline Zone control functions.

Status of the Multiline Zone control

If the Multiline Zone control is "inactive" or "grayed", the click process is not run and its rows cannot be selected.
Related Examples:
WM CRM Cross-platform examples (WINDEV Mobile): WM CRM
[ + ] WM CRM is a multi-platform project for Android and iOS.
It explains how to develop a CRM application intended to the Android and iPad tablets.
The Multiline Zone control Unit examples (WINDEV): The Multiline Zone control
[ + ] Using a Multiline Zone control
Minimum version required
  • Version 17
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 09/08/2023

Send a report | Local help