Plane (Property)

Find out the active plane of a window (or report) or the plane to which a control belongs.
Modify the active plane of a window (or report) or associate a control with another plane.

Remarks:

A plane is a "layer":
- of a window,
- Versions 19 and later
  of a report.
  New in version 19
  of a report.
  of a report.
Several planes cannot be viewed at the same time (in the window editor, page editor, report editor, or in your applications).
In a window or in a report, each control can:
- belong to no plane. This control will always be displayed, regardless of the current plane.
- belong to a plane. This control will be displayed when the corresponding plane is visible.
- Versions 19 and later
  belong to several planes. This control will be displayed when one of the planes associated with the control is enabled (which means visible).
  New in version 19
  belong to several planes. This control will be displayed when one of the planes associated with the control is enabled (which means visible).
  belong to several planes. This control will be displayed when one of the planes associated with the control is enabled (which means visible).
Versions 19 and later
The planes in the reports are mainly used to replace the substitution blocks: all you have to do is position the controls on several planes and enable the requested plane during the print.
New in version 19
The planes in the reports are mainly used to replace the substitution blocks: all you have to do is position the controls on several planes and enable the requested plane during the print.
The planes in the reports are mainly used to replace the substitution blocks: all you have to do is position the controls on several planes and enable the requested plane during the print.

Versions 18 and later

This property is now available in Windows Store apps mode.

New in version 18

This property is now available in Windows Store apps mode.

Versions 19 and later

This property is now available for reports and report controls.

New in version 19

This property is now available for reports and report controls.

Versions 21 and later

This property is now available in Universal Windows 10 App mode.

New in version 21

This property is now available in Universal Windows 10 App mode.

Versions 22 and later

This property is now available in WEBDEV sites.

New in version 22

This property is now available in WEBDEV sites.

Example

// Modify the active plane
WIN_EditWindow..Plane = 2

Syntax

Finding out the active plane of a window (or report) or the plane to which a control belongs Hide the details

<Plane number> = <Element used>..Plane

<Plane number>: Integer or character string

Number of the active plane in the specified window.
Versions 19 and later
Number of the active plane in the specified report.
New in version 19
Number of the active plane in the specified report.
Number of the active plane in the specified report.
Number of the plane to which the specified control belongs.
Versions 19 and later
Numbers of the planes (separated by a comma) to which the control belongs.
New in version 19
Numbers of the planes (separated by a comma) to which the control belongs.
Numbers of the planes (separated by a comma) to which the control belongs.

<Element used>: Name of control, window or report

Name of element to use:
Control name.
Window name.
Versions 19 and later
Report name.
New in version 19
Report name.
Report name.

Modifying the active plane of a window (or report) or associating a control with another plane Hide the details

<Element used>..Plane = <New plane>

<Element used>: Name of control, window or report

Name of element to use:
Control name.
Window name.
Versions 19 and later
Report name.
New in version 19
Report name.
Report name.

<New plane>: Integer or character string

Number of the plane to activate. If this number is greater than the number of existing planes, only the controls not assigned to a plane will be displayed.
Number of the plane associated with the specified control. The control will no longer be displayed if this number does not correspond to the current plane.
Versions 19 and later
Numbers of the planes associated with the control. These numbers are supplied in character string format and they are separated by a comma.
New in version 19
Numbers of the planes associated with the control. These numbers are supplied in character string format and they are separated by a comma.
Numbers of the planes associated with the control. These numbers are supplied in character string format and they are separated by a comma.
Versions 23 and later
Number of the plane to activate (for the windows only). The plane name was defined in the window for plane management in the window editor.
New in version 23
Number of the plane to activate (for the windows only). The plane name was defined in the window for plane management in the window editor.
Number of the plane to activate (for the windows only). The plane name was defined in the window for plane management in the window editor.

Remarks

Plane and window

If a control is assigned to no plane (<None> selected in the description window), this control will always be displayed, regardless of the active plane in the window or report.
If a control is assigned to a plane, this control will be displayed only if it belongs to the active plane in the window or report.
Versions 19 and later
If a control is assigned to several planes, this control will be displayed as soon as one of these planes is enabled (which means visible).
New in version 19
If a control is assigned to several planes, this control will be displayed as soon as one of these planes is enabled (which means visible).
If a control is assigned to several planes, this control will be displayed as soon as one of these planes is enabled (which means visible).
When opening a window or report, the active plane is plane #0.

Plane and internal window

When ..Plane is used directly on an internal window, this property applies to the controls found in the internal window. For example, to display the plane 2 of the internal window from the host window or directly in the internal window, use the following code line:

<Name of Internal Window>..Plane = 2

When ..Plane is used on the host window of an internal window, this property applies to all the controls found in the host window (including the internal window control if it is associated with a plane).

Versions 19 and later

Plane and internal report

When ..Plane is used directly on the internal report, this property applies to the controls found in the internal report. For example, to display the plane 2 of the internal report from the host report or directly in the internal report, use the following code line:

<Name of Internal Report>..Plane = 2

When ..Plane is used on the host report of the internal report, this property applies to all the controls found in the host report (including the internal report control if it is associated with a plane).

New in version 19

Plane and internal report

<Name of Internal Report>..Plane = 2

Plane and internal report

<Name of Internal Report>..Plane = 2

Limits

..Plane cannot be used on:

an option in a Check Box or Radio Button control,
a row in a Table, List Box or Combo Box control,
a cell in a Table control,
a column in Table control,
a window menu,
a tab pane,
a group of controls,

..Plane only applies to the following elements:

Button control.
Static control.
Edit control.
Image control.
Check Box control.
Radio Button control.
List Box control.
Combo Box control.
TreeView control.
Tab control.
Window control.
Table control.
Supercontrol control.

Versions 19 and later

..Plane is not available for reports.

New in version 19

..Plane is not available for reports.