The Multiline Zone control

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Help

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:

lines defined in edit (static lines).
lines defined at run time, by programming (dynamic lines).

Versions 18 and later

The Multiline Zone control is now available for the Android applications.

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

New in version 18

The Multiline Zone control is now available for the Android applications.

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

The Multiline Zone control is now available for the Android applications.

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

Versions 21 and later

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

New in version 21

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

Creating a Multiline Zone control

To create a Multiline Zone control:

In the window editor, click (or select "Insert .. Control .. Multiline zone").
Click the position where the control will be created in the window.

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".
  New in version 18
  expand "Looper" and click "Multiline zone".
  expand "Looper" and click "Multiline zone".
Click the position where the control will be created in the window.

Notes:

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 created control are optimized in order to occupy the available space at the specified position. If the control size does not suit you, press Ctrl + Z: the default control size will be restored.
New in version 20
The dimensions of created control are optimized in order to occupy the available space at the specified position. If the control size does not suit you, press Ctrl + Z: the default control size will be restored.
The dimensions of created control are optimized in order to occupy the available space at the specified position. If the control size does not suit you, press Ctrl + Z: the default control size will be restored.

By default, the created control contains a single empty "static" line. 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

Describing a line

The "General" tab in the description window of a multiline zone is used to:

define the parameters of the current line,
add a new line,
Versions 22 and later
duplicate an existing line,
New in version 22
duplicate an existing line,
duplicate an existing line,
delete an existing line.

When adding a new line ("New line" button) or when modifying the current line ("Modify the line type" button or double click on the line), a wizard allows you to create a default content, corresponding to the most common uses:When adding a new line ("New line") or when modifying the current line ("Modify the type of line" or double-click on the line), a wizard starts and allows you to create a default content, according 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 lines.

The controls corresponding to the selected line 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 line.

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 line.

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 line.

Static use of the Multiline Zone control

A multiline zone is static if "Define as being the repeated line of control" ("General" tab) is not checked for any of the lines.A Multiline Zone control is static if the option"Define as being the repeated line of the control" ("General" tab) is not checked for any of the lines.

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, his address, ...

In this case, the content will be static and the number of lines will be fixed. For example, for the identity:

a line for the company,
a line for the last name,
a line for the first name.

In this case, the controls found on each line are linked to the corresponding item in the data file of customers.

Another example: a static Multiline Zone control used to have the behavior of a selector:

Dynamic use of a Multiline Zone control

A Multiline Zone control is dynamic if the option "Define as being the repeated line of the control" ("General" tab) is not checked for any of the lines. This option can be checked for a single line only.

In this case, lines 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 line is a static line and the lines of products correspond to a dynamic line in the editor.

A line can be added by mlzAddLine. For more details on the functions for handling dynamic Multiline Zone controls, see Functions for managing the 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 lines 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