ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage properties / Properties associated with windows, pages and controls
  • Plane and window
  • Plane and internal window
  • Planes and Cell control
  • Plane and internal report
  • Limitations
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
The Plane property is used to:
  • Get 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,
    • 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.
    • belong to several planes. This control will be displayed when one of the planes associated with the control is enabled (which means visible).
  • The planes in the reports are mainly used to replace the substitution blocks: simply position the controls on several planes and enable the desired plane when print.
Example
WINDEVUniversal Windows 10 AppJava
// Modify the active plane
WIN_EditWindow.Plane = 2
Syntax

Get 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.
  • Number of the active plane in the specified report.
  • Number of the plane to which the specified 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 the element to be used:
  • Control name.
  • Name of the window.
  • 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 the element to be used:
  • Control name.
  • Name of the window.
  • 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.
  • Numbers of the planes associated with the control. These numbers are supplied in character string format and they are separated by a comma.
  • WINDEV Number of the plane to activate (for the windows only). The plane name was defined in the plane management window in the window editor.
Remarks
WINDEVUniversal Windows 10 AppJava

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

Plane and internal window

The Plane property can be used:
  • directly on the internal window. In this case, this property handles the controls of the internal window.
    For example, to display plane 2 of the internal window from the host window or directly in the internal window, use the following line of code:
    <Name of internal window>.Plane = 2
  • directly on the window that hosts the Internal Window control. In this case, the property will only apply to the controls in the host window (including the Internal Window control if it is associated with a plane). The content of the internal window will not be modified. The following line of code should be used:
    <Window name>.Plane = 2
New in version 2024
The ActivePlane property can also be used. The same behavior applies.
New in version 2024
WINDEV

Planes and Cell control

The Plane property can be used on Cell controls. In this case, it gets and sets the plane to which the Cell control belongs, relative to its parent (window or internal window).
For example, the following line of code displays the Cell control on plane 2 of the window:
<Cell control name>.Plane = 2
To get and set the active plane of the Cell control, use the ActivePlane property.
For example, the following line of code displays plane 2 of the Cell control:
<Cell control name>.ActivePlane = 2

Plane and internal report

The Plane property can be used:
  • directly on the internal report. In this case, this property handles the controls of 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
  • directly on the window that hosts the Internal Report control. In this case, the property will only apply to the controls in the host report (including the Internal Report control if it is associated with a plane). The content of the internal report will not be modified. The following line of code should be used:
    <Report name>.Plane = 2

Limitations

The Plane property 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 a Table control,
  • a window menu,
  • a tab pane,
  • a group of controls,
Java The Plane property can only be used with 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.
Universal Windows 10 App The Plane property is not available for reports.
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 02/05/2024

Send a report | Local help