ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / Developing an application or website / Controls, windows and pages / Plane
  • Overview
  • Assigning one or more controls to one or more planes
  • Selecting the plane displayed in the editor
  • Changing plane through programming
  • Changing plane in a window
  • Changing plane in a report
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
Overview
The planes are used to group the window controls. A plane is a window "layer". Each window can include several planes.
The controls can be positioned on different planes. A single plane can be displayed at a time in the window editor and when running the program.
Each window control can:
  • belong to no plane: it will always be displayed, regardless of the current plane
  • belong to a plane. This control will be displayed when the corresponding plane 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).
Remarks:
  • The planes are also available in the reports. 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.
Assigning one or more controls to one or more planes
To assign one or more controls to one or more planes:
  1. Select the controls.
  2. Select:
    • "Associate .. with a plane" in the context menu of the control or selection of controls in a window.
    • "Associate with a plane" in the context menu of the control or selection of controls in a report.
  3. In the window that appears, choose:
    • "No plane" if the control must be associated with no plane,
    • one of the available planes.
    • several planes (to do so, keep the Ctrl key down while selecting planes).
Remarks:
  • The number of planes is unlimited. However, the window editor or the report editor may prevent you from selecting the planes greater than 98.
  • A control can also be assigned to a plane from the control description window:
    • in the window editor: "Details" tab, "Plane" option.
    • in the report editor: "UI" tab, "Plane" option.
  • When assigning a control to a plane, the control may not be displayed in the current window or report anymore: the current plane differs from the plane assigned to the control.
  • The assignments window lists the planes used then the blank planes. The buttons found at the bottom of this window simplify the move between the different types of planes.
Selecting the plane displayed in the editor
To display a specific plane in the editor, you can:
  • In the window editor: on the "Window" tab, in the "Associate" group, expand "Planes". In the window that is opened, simply choose the plane to display in the "Navigation" section.
  • In the report editor: on the "Modification" tab, in the "Planes" group, expand "Planes". In the window that is opened, simply choose the plane to display in the "Navigation" section.
  • Press the PgDn and PgUp keys. These keys are used to display the different planes of current window or report.
  • Press Ctrl + PgDn and Ctrl + PgUp. These keys are used to display the different planes containing controls (non-empty planes) of the current window or report.
  • Type the number of the plane to display in the status bar of window or report editor.
Changing plane through programming
The Plane property allows you to:
  • find out and change the current plane in a window or report.
  • find out and change the plane associated with a control.

Changing plane in a window

Changing plane in a window can be performed at any time. A button is often used to change plane.
Example:
// Switch to plane 4 for adding orders
WIN_CRM.Plane = 4
The change of plane is immediate: only the controls associated with the plane are displayed.
Remark: If the planes have been named in the window editor, the plane name can be used instead of the plane number.

Changing plane in a report

The change of plane in a report must be done when printing the report. It is recommended to use the Plane property in one of the events associated with the report, blocks or controls.
// Open the report
// Display plane 2
MyReport.Plane = 2
The change of plane is immediate: only the controls associated with the plane are printed.
Remark: Replacing the substitution blocks by planes:
Until version 18, the substitution blocks were used to replace a block by another one during the print. However, to avoid the print problems, it was recommend to create substitution blocks with the same height as the block to replace.
From version 19, the planes can easily replace a substitution block. To do so, you must:
  • in the editor: position the controls of the substitution block in the desired block and assign them to a plane.
  • programmatically: replace the call to iSubstBlock with a call to the Plane property to display the desired plane.
Related Examples:
WD Wizard Training (WINDEV): WD Wizard
[ + ] This example explains how to create a "Wizard" window with the WLanguage functions.
The following topics are presented in this example:
1/ the management of planes
2/ the dynamic modification of a static

Summary of the example supplied with WINDEV:
This example explains how to easily manage a "Wizard" in a window via the concept of planes. The user is guided step by step by clicking the "Next", "Previous" and "Done" buttons
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: 06/23/2023

Send a report | Local help