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.
Versions 22 and later
Find out the active plane of an element.
New in version 22
Find out the active plane of an element.
Find out the active plane of an element.
Versions 22 and later
Modify the active plane of an element.
New in version 22
Modify the active plane of an element.
Modify the active plane of an element.

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.
- Versions 22 and later
  of an element (page, page template, cell, internal page, ...).
  New in version 22
  of an element (page, page template, cell, internal page, ...).
  of an element (page, page template, cell, internal page, ...).
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 22 and later
The planes can be enabled for the following elements:
- the pages
- the internal pages
- the cells
- the layout areas
- the popups
- supercontrols
- control templates,
- the page templates.
New in version 22
The planes can be enabled for the following elements:
- the pages
- the internal pages
- the cells
- the layout areas
- the popups
- supercontrols
- control templates,
- the page templates.
The planes can be enabled for the following elements:
- the pages
- the internal pages
- the cells
- the layout areas
- the popups
- supercontrols
- control templates,
- the page templates.

Versions 15 and later

This property is now available for Android applications.

New in version 15

This property is now available for Android applications.

Versions 17 and later

This property is now available for iPhone/iPad applications.

New in version 17

This property is now available for iPhone/iPad applications.

Versions 18 and later

This property is now available in Windows Store apps mode.

This property is now available in Android Widget mode.

New in version 18

This property is now available in Windows Store apps mode.

This property is now available in Android Widget mode.

This property is now available in Windows Store apps mode.

This property is now available in Android Widget mode.

Versions 19 and later

This property is now available for reports and report controls.

This property is only available for reports and report controls.

New in version 19

This property is now available for reports and report controls.

This property is only available for reports and report controls.

This property is now available for reports and report controls.

This property is only 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.

This property is now available for WEBDEV sites in PHP.

This function is now available in browser code.

New in version 22

This property is now available in WEBDEV sites.

This property is now available for WEBDEV sites in PHP.

This function is now available in browser code.

This property is now available in WEBDEV sites.

This property is now available for WEBDEV sites in PHP.

This function is now available in browser code.

Example

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

Versions 22 and later

// Switch to plane 4 for adding orders
PAGE_CRM.CELL_OrdCell..Plane = 4

New in version 22

// Switch to plane 4 for adding orders
PAGE_CRM.CELL_OrdCell..Plane = 4

// Switch to plane 4 for adding orders
PAGE_CRM.CELL_OrdCell..Plane = 4

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.

Versions 22 and later

Finding out the active plane of an element Hide the details

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

<Plane number>: Integer or character string

Number of the active plane in the specified element.

<Element used>: Name of control or page

Name of element to use. This element can be:
a page
an internal page
a cell
a layout area
a popup
a supercontrol
a control template,
a page template.

New in version 22

Finding out the active plane of an element Hide the details

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

<Plane number>: Integer or character string

Number of the active plane in the specified element.

<Element used>: Name of control or page

Name of element to use. This element can be:
a page
an internal page
a cell
a layout area
a popup
a supercontrol
a control template,
a page template.

Finding out the active plane of an element Hide the details

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

<Plane number>: Integer or character string

Number of the active plane in the specified element.

<Element used>: Name of control or page

Name of element to use. This element can be:
a page
an internal page
a cell
a layout area
a popup
a supercontrol
a control template,
a page template.

Versions 22 and later

Modifying the active plane of an element Hide the details

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

<Element used>: Name of control or page

Name of element to use. This element can be:
a page
an internal page
a cell
a layout area
a popup
a supercontrol
a control template,
a page template.

<New plane>: Integer or character string

Number of the plane to activate.

New in version 22

Modifying the active plane of an element Hide the details

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

<Element used>: Name of control or page

Name of element to use. This element can be:
a page
an internal page
a cell
a layout area
a popup
a supercontrol
a control template,
a page template.

<New plane>: Integer or character string

Number of the plane to activate.

Modifying the active plane of an element Hide the details

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

<Element used>: Name of control or page

Name of element to use. This element can be:
a page
an internal page
a cell
a layout area
a popup
a supercontrol
a control template,
a page template.

<New plane>: Integer or character string

Number of the plane to activate.

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.

Versions 22 and later

Plane and WEBDEV elements

Planes are available for some elements.
To use the management of planes on an element, it must be enabled in the editor ("UI" tab of the element description).
You have the ability to display effects when changing plane.

See The planes in WEBDEV for more details.

New in version 22

Plane and WEBDEV elements

Planes are available for some elements.
To use the management of planes on an element, it must be enabled in the editor ("UI" tab of the element description).
You have the ability to display effects when changing plane.

See The planes in WEBDEV for more details.

Plane and WEBDEV elements

Planes are available for some elements.
To use the management of planes on an element, it must be enabled in the editor ("UI" tab of the element description).
You have the ability to display effects when changing plane.

See The planes in WEBDEV for more details.

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,
a TreeView control.

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

..Plane only applies to the following elements:

Button control.
Static control.
Image control.
Window.

Versions 19 and later

..Plane is not available for reports.

New in version 19

..Plane is not available for reports.

Versions 22 and later

..Plane only applies to the following elements:

the pages
the internal pages
the cells
the layout areas
the popups
supercontrols
control templates,
the page templates.

New in version 22

..Plane only applies to the following elements:

the pages
the internal pages
the cells
the layout areas
the popups
supercontrols
control templates,
the page templates.

..Plane only applies to the following elements:

the pages
the internal pages
the cells
the layout areas
the popups
supercontrols
control templates,
the page templates.