ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage properties / Properties associated with windows, pages and controls
  • Planes and internal reports
  • 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.
  • Change 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 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 active (i.e. visible).
  • The planes in the reports are mainly used to replace substitution blocks: simply position the controls on several planes and activate the desired plane when printing.
Example
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.

Changing 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 that are not assigned to a plane will be displayed.
  • Number of the plane associated with the specified control. If this number does not correspond to the current plane, the control will not be displayed.
  • Numbers of the planes associated with the control. These numbers are in a comma-separated string.
Remarks

Planes and internal reports

The Plane property can be used:
  • directly on the internal report. In this case, this property applies to the controls of the internal report.
    For example, to display plane 2 of the internal report from the host report or directly in the internal report, use the following line of code:
    <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,
Minimum version required
  • Version 9
This page is also available for…
Comments
Obs


Os planes normalmente se usa uma quantidade limitada no máximo 3 onde pode por na plane 1 o table grid, na plane 2 os campos do formulário e na plane 3 o select view.

Lembro que a janela só vai abrir se todo o oconteudo for carregado na memória, deve ser usado com extrema prudência.


A limited number of planes are normally used, at most 3, where you can put the table grid on plane 1, the form fields on plane 2 and the select view on plane 3.

Remember that the window will only open if all the content is loaded into memory, it must be used with extreme caution.
Boller
15 Mar. 2024

Last update: 02/06/2024

Send a report | Local help