The Multiline Zone control

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Help

Editors

Controls (window/page/report)

Controls

Multiline Zone control

The Multiline Zone control

Overview of the Multiline Zone control

Creating a Multiline Zone control

Characteristics of the Multiline Zone control

Related examples

See also

The Multiline Zone control

Overview of the Multiline Zone control

The Multiline Zone control allows you to easily create interfaces in iOS style. For example:

This control is used to group several controls:

options on a category,
group of information about a contact,
...

This control can contain at the same time:

rows defined in edit mode (static rows).
rows defined at runtime, by programming (dynamic rows).

Versions 18 and later

The Multiline Zone control is now available for Android applications.

The Multiline Zone control is now available for WINDEV applications for Windows.

New in version 18

The Multiline Zone control is now available for Android applications.

The Multiline Zone control is now available for WINDEV applications for Windows.

The Multiline Zone control is now available for Android applications.

The Multiline Zone control is now available for WINDEV applications for Windows.

Versions 21 and later

The Multiline Zone control is now available for applications in Universal Windows 10 App mode.

New in version 21

The Multiline Zone control is now available for applications in Universal Windows 10 App mode.

Creating a Multiline Zone control

To create a Multiline Zone control:

On the "Creation" pane, in the "Data" group:
- click "Multiline zone".
- Versions 18 and later
  expand "Looper" and click "Multiline zone".
  1. Click the position where the control will be created in the window.
  New in version 18
  expand "Looper" and click "Multiline zone".
  1. Click the position where the control will be created in the window.
  expand "Looper" and click "Multiline zone".
  1. Click the position where the control will be created in the window.

Remarks:

The window creation wizard for iPhone and iPad also allows you to create preset Multiline Zone controls. See Windows for iPhone and iPad for more details.
Versions 20 and later
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.
New in version 20
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.
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 display the control characteristics, select "Description" from the popup menu of control.

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,
Versions 22 and later
duplicate an existing row,
New in version 22
duplicate an existing row,
duplicate an existing row,
delete an existing row.

When adding a new row ("New row" button) or when modifying the current row ("Modify type of row" button or double-click on the row), a wizard starts and allows creating a default content, corresponding to the most common uses:

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.

Versions 18 and later

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.

New in version 18

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.

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 option "Define as the repeated row of the control" ("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 option "Define as the repeated row of the control" ("General" tab) is not checked for any of the rows. This option can be checked for a single row only.

In this case, rows can be added by 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.

mlzAddLine adds a row. For more details on the functions for handling dynamic Multiline Zone controls, see Functions for managing Multiline Zone controls.

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:

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.

Unit examples (WINDEV): The Multiline Zone control

[ + ] Using a Multiline Zone control