PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Overview
  • Assigning one or more controls to one or more planes
  • Selecting the plane displayed in the editor
  • Editing planes in the window editor
  • Managing planes
  • Displaying the window for plane management
  • Name the planes
  • Modify the order of planes
  • Adding or deleting planes
  • Changing plane by 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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
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).
  • 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
Note: The planes are also available in the reports. 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
Note: The planes are also available in the reports. 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.
Note: The planes are also available in the reports. 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.
Notes:
  • The planes are also available in the reports. 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
    WEBDEV - Server codeWEBDEV - Browser codePHP The planes can be used on the pages and on the container controls. See The planes in WEBDEV for more details
    New in version 22
    WEBDEV - Server codeWEBDEV - Browser codePHP The planes can be used on the pages and on the container controls. See The planes in WEBDEV for more details
    WEBDEV - Server codeWEBDEV - Browser codePHP The planes can be used on the pages and on the container controls. See The planes in WEBDEV for more details
  • Versions 23 and later
    WINDEVWINDEV Mobile The window editor proposes an advanced plane management allowing you to name the planes. See Editing planes in the window editor for more details.
    New in version 23
    WINDEVWINDEV Mobile The window editor proposes an advanced plane management allowing you to name the planes. See Editing planes in the window editor for more details.
    WINDEVWINDEV Mobile The window editor proposes an advanced plane management allowing you to name the planes. See Editing planes in the window editor for more details.
Versions 15 and later
Android The planes are now available for the Android applications.
New in version 15
Android The planes are now available for the Android applications.
Android The planes are now available for the Android applications.
Versions 17 and later
iPhone/iPad The planes are now available for the iPhone/iPad applications.
New in version 17
iPhone/iPad The planes are now available for the iPhone/iPad applications.
iPhone/iPad The planes are now available for the iPhone/iPad applications.
Versions 18 and later
Universal Windows 10 App The planes are now available for the applications in Windows Store apps mode.
Android Widget The planes are now available in Widget Android mode.
New in version 18
Universal Windows 10 App The planes are now available for the applications in Windows Store apps mode.
Android Widget The planes are now available in Widget Android mode.
Universal Windows 10 App The planes are now available for the applications in Windows Store apps mode.
Android Widget The planes are now available in Widget Android mode.
Versions 21 and later
Universal Windows 10 App The planes are now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App The planes are now available in Universal Windows 10 App mode.
Universal Windows 10 App The planes are now available in Universal Windows 10 App mode.
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" from the popup menu of selection.
    • "Associate with a plane" from the popup menu of control.
  3. In the window that is displayed, choose:
    • "No plane" if the control must be associated with no plane,
    • one of the available planes.
    • Versions 19 and later
      several planes (to do so, keep the [CTRL] key down while selecting planes).
      New in version 19
      several planes (to do so, keep the [CTRL] key down while selecting planes).
      several planes (to do so, keep the [CTRL] key down while selecting planes).
Notes:
  • 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 description window of control:
    • in the window editor: "Details" tab, "Plane" option.
    • Versions 19 and later
      in the report editor: "GUI" tab, "Plane" option.
      New in version 19
      in the report editor: "GUI" tab, "Plane" option.
      in the report editor: "GUI" 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.
  • Versions 19 and later
    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.
    New in version 19
    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.
    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: select "Display .. Go to plane" and choose the plane to display.In the window editor: in the "Window" pane, in the "Associate" group, expand "Planes". In the window that is opened, all you have to do is choose the plane to display in the "Navigation" section.
  • Versions 19 and later
    In the report editor: on the "Modification" pane, in the "Planes" group, expand "Planes". In the window that is opened, all you have to do is choose the plane to display in the "Navigation" section.
    New in version 19
    In the report editor: on the "Modification" pane, in the "Planes" group, expand "Planes". In the window that is opened, all you have to do is choose the plane to display in the "Navigation" section.
    In the report editor: on the "Modification" pane, in the "Planes" group, expand "Planes". In the window that is opened, all you have to do is choose the plane to display in the "Navigation" section.
  • Press [Page up] and [Page down]. These keys are used to display the different planes of current window or report.
  • Press [Ctrl][Page up] and [Ctrl][Page down]. These keys are used to display the different planes containing controls (non-empty planes) of current window or report.
  • Type the number of the plane to display in the status bar of window or report editor.
Versions 23 and later
WINDEVWINDEV Mobile
Editing planes in the window editor

Managing planes

The management of planes can be performed from the window editor. You can:

Displaying the window for plane management

To display the window for plane management (and see the different window planes):
  1. On the "Window" pane, in the "Associate" group, expand "Planes" and select "Edit the planes" (or press ALT + Page down).
  2. The displayed window presents a thumbnail of all window planes. These thumbnails are classiffied according to their order number.
Note: All the planes containing controls are displayed. The empty planes found between two planes containing controls are also displayed: they are grayed.

Name the planes

The planes are numbered by default. If a plane is deleted, all the following planes are automatically re-numbered. To be independent from the plane number, the window editor allows you to name and reorganize the window planes.
To name the planes:
  1. In the window for plane management, select the thumbnail of plane to rename.
  2. Click the "Pen" icon:
  3. Type the plane name in the area that is displayed:
  4. Validate. The plane is named. The appears above the plane thumbnail.
  5. Validate the window for plane management. The plane name appears in the window editor, below the plane number.
Note: Case of window templates: You have the ability to name planes in the window templates. If a window that is using a template overloads the naming of template planes, the naming of planes will no longer be updated when refreshing the template.

Modify the order of planes

The planes are displayed in their creation order by default. The window for plane management is used to modify the order of planes.
To modify the order of planes:
  1. In the window for plane management, select the thumbnail of plane to move.
  2. Drag and Drop the thumbnail to the new requested position: the thumbnails representing the other planes are moved in order to see the final position of moved plane.
  3. Drop the thumbnail of moved plane on its new location. In case of doubt, the number of insertion plane is requested.
  4. All the affected planes are re-numbered. The names of planes are unchanged.
  5. Validate the window for plane management to take the modifications into account.
To swap the position of two planes:
  1. In the window for plane management, select the thumbnail of two planes whose positions must be swapped (press the [CTRL] key to perform a multi-selection).
  2. Display the popup menu of selection (right mouse click) and select "Exchange".
  3. The thumbnails of two planes are swapped and the planes are re-numbered if necessary.
  4. Validate the window for plane management to take the modifications into account.

Adding or deleting planes

The window for plane management allows you to add or delete empty planes.
To add an empty plane:
  1. In the window for plane management, select the thumbnail of the plane in front of which an empty plane will be inserted.
  2. Display the popup menu of selection (right mouse click) and select "Insert an empty plane".
  3. The empty plane is inserted and all the affected planes are re-numbered. The names of planes are unchanged.
  4. Validate the window for plane management to take the modifications into account.
To add a set of empty planes:
  1. In the window for plane management, select the thumbnail of the plane in front of which the empty planes will be inserted.
  2. Display the popup menu of selection (right mouse click) and select "Start from plane".
  3. In the window that is displayed, specify the number at which this plane will be positioned.
  4. Validate. As many empty planes as necessary will be inserted in front of the selected plane. All the affected planes are re-numbered. The names of planes are unchanged.
  5. Validate the window for plane management to take the modifications into account.
Note: If more than 6 empty planes are displayed one after another, only the first and last empty planes will be displayed in the window for plane management.
To delete an empty plane:
  1. In the window for plane management, select the thumbnail of empty plane to delete.
  2. Display the popup menu of selection (right mouse click) and select "Delete".
  3. The empty plane is deleted and all the affected planes are re-numbered. The names of planes are unchanged.
  4. Validate the window for plane management to take the modifications into account.
New in version 23
WINDEVWINDEV Mobile
Editing planes in the window editor

Managing planes

The management of planes can be performed from the window editor. You can:

Displaying the window for plane management

To display the window for plane management (and see the different window planes):
  1. On the "Window" pane, in the "Associate" group, expand "Planes" and select "Edit the planes" (or press ALT + Page down).
  2. The displayed window presents a thumbnail of all window planes. These thumbnails are classiffied according to their order number.
Note: All the planes containing controls are displayed. The empty planes found between two planes containing controls are also displayed: they are grayed.

Name the planes

The planes are numbered by default. If a plane is deleted, all the following planes are automatically re-numbered. To be independent from the plane number, the window editor allows you to name and reorganize the window planes.
To name the planes:
  1. In the window for plane management, select the thumbnail of plane to rename.
  2. Click the "Pen" icon:
  3. Type the plane name in the area that is displayed:
  4. Validate. The plane is named. The appears above the plane thumbnail.
  5. Validate the window for plane management. The plane name appears in the window editor, below the plane number.
Note: Case of window templates: You have the ability to name planes in the window templates. If a window that is using a template overloads the naming of template planes, the naming of planes will no longer be updated when refreshing the template.

Modify the order of planes

The planes are displayed in their creation order by default. The window for plane management is used to modify the order of planes.
To modify the order of planes:
  1. In the window for plane management, select the thumbnail of plane to move.
  2. Drag and Drop the thumbnail to the new requested position: the thumbnails representing the other planes are moved in order to see the final position of moved plane.
  3. Drop the thumbnail of moved plane on its new location. In case of doubt, the number of insertion plane is requested.
  4. All the affected planes are re-numbered. The names of planes are unchanged.
  5. Validate the window for plane management to take the modifications into account.
To swap the position of two planes:
  1. In the window for plane management, select the thumbnail of two planes whose positions must be swapped (press the [CTRL] key to perform a multi-selection).
  2. Display the popup menu of selection (right mouse click) and select "Exchange".
  3. The thumbnails of two planes are swapped and the planes are re-numbered if necessary.
  4. Validate the window for plane management to take the modifications into account.

Adding or deleting planes

The window for plane management allows you to add or delete empty planes.
To add an empty plane:
  1. In the window for plane management, select the thumbnail of the plane in front of which an empty plane will be inserted.
  2. Display the popup menu of selection (right mouse click) and select "Insert an empty plane".
  3. The empty plane is inserted and all the affected planes are re-numbered. The names of planes are unchanged.
  4. Validate the window for plane management to take the modifications into account.
To add a set of empty planes:
  1. In the window for plane management, select the thumbnail of the plane in front of which the empty planes will be inserted.
  2. Display the popup menu of selection (right mouse click) and select "Start from plane".
  3. In the window that is displayed, specify the number at which this plane will be positioned.
  4. Validate. As many empty planes as necessary will be inserted in front of the selected plane. All the affected planes are re-numbered. The names of planes are unchanged.
  5. Validate the window for plane management to take the modifications into account.
Note: If more than 6 empty planes are displayed one after another, only the first and last empty planes will be displayed in the window for plane management.
To delete an empty plane:
  1. In the window for plane management, select the thumbnail of empty plane to delete.
  2. Display the popup menu of selection (right mouse click) and select "Delete".
  3. The empty plane is deleted and all the affected planes are re-numbered. The names of planes are unchanged.
  4. Validate the window for plane management to take the modifications into account.
WINDEVWINDEV Mobile
Editing planes in the window editor

Managing planes

The management of planes can be performed from the window editor. You can:

Displaying the window for plane management

To display the window for plane management (and see the different window planes):
  1. On the "Window" pane, in the "Associate" group, expand "Planes" and select "Edit the planes" (or press ALT + Page down).
  2. The displayed window presents a thumbnail of all window planes. These thumbnails are classiffied according to their order number.
Note: All the planes containing controls are displayed. The empty planes found between two planes containing controls are also displayed: they are grayed.

Name the planes

The planes are numbered by default. If a plane is deleted, all the following planes are automatically re-numbered. To be independent from the plane number, the window editor allows you to name and reorganize the window planes.
To name the planes:
  1. In the window for plane management, select the thumbnail of plane to rename.
  2. Click the "Pen" icon:
  3. Type the plane name in the area that is displayed:
  4. Validate. The plane is named. The appears above the plane thumbnail.
  5. Validate the window for plane management. The plane name appears in the window editor, below the plane number.
Note: Case of window templates: You have the ability to name planes in the window templates. If a window that is using a template overloads the naming of template planes, the naming of planes will no longer be updated when refreshing the template.

Modify the order of planes

The planes are displayed in their creation order by default. The window for plane management is used to modify the order of planes.
To modify the order of planes:
  1. In the window for plane management, select the thumbnail of plane to move.
  2. Drag and Drop the thumbnail to the new requested position: the thumbnails representing the other planes are moved in order to see the final position of moved plane.
  3. Drop the thumbnail of moved plane on its new location. In case of doubt, the number of insertion plane is requested.
  4. All the affected planes are re-numbered. The names of planes are unchanged.
  5. Validate the window for plane management to take the modifications into account.
To swap the position of two planes:
  1. In the window for plane management, select the thumbnail of two planes whose positions must be swapped (press the [CTRL] key to perform a multi-selection).
  2. Display the popup menu of selection (right mouse click) and select "Exchange".
  3. The thumbnails of two planes are swapped and the planes are re-numbered if necessary.
  4. Validate the window for plane management to take the modifications into account.

Adding or deleting planes

The window for plane management allows you to add or delete empty planes.
To add an empty plane:
  1. In the window for plane management, select the thumbnail of the plane in front of which an empty plane will be inserted.
  2. Display the popup menu of selection (right mouse click) and select "Insert an empty plane".
  3. The empty plane is inserted and all the affected planes are re-numbered. The names of planes are unchanged.
  4. Validate the window for plane management to take the modifications into account.
To add a set of empty planes:
  1. In the window for plane management, select the thumbnail of the plane in front of which the empty planes will be inserted.
  2. Display the popup menu of selection (right mouse click) and select "Start from plane".
  3. In the window that is displayed, specify the number at which this plane will be positioned.
  4. Validate. As many empty planes as necessary will be inserted in front of the selected plane. All the affected planes are re-numbered. The names of planes are unchanged.
  5. Validate the window for plane management to take the modifications into account.
Note: If more than 6 empty planes are displayed one after another, only the first and last empty planes will be displayed in the window for plane management.
To delete an empty plane:
  1. In the window for plane management, select the thumbnail of empty plane to delete.
  2. Display the popup menu of selection (right mouse click) and select "Delete".
  3. The empty plane is deleted and all the affected planes are re-numbered. The names of planes are unchanged.
  4. Validate the window for plane management to take the modifications into account.
Changing plane by programming
..Plane is used 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.
Versions 23 and later
Note: If the planes have been named in the window editor, the plane name can be used instead of the plane number.
New in version 23
Note: If the planes have been named in the window editor, the plane name can be used instead of the plane number.
Note: If the planes have been named in the window editor, the plane name can be used instead of the plane number.
Versions 19 and later

Changing plane in a report

The change of plane in a report must be done when printing the report. We recommend that you use ..Plane in one of the processes of report, blocks or controls.
// Opening process of the report
// Display the plane 2
MyReport..Plane = 2
The change of plane is immediate: only the controls associated with the plane are printed.
Note: 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 requested block and assign them to a plane.
  • by programming: replace the call to iSubstBlock by a call to ..Plane in order to display the requested plane.
New in version 19

Changing plane in a report

The change of plane in a report must be done when printing the report. We recommend that you use ..Plane in one of the processes of report, blocks or controls.
// Opening process of the report
// Display the plane 2
MyReport..Plane = 2
The change of plane is immediate: only the controls associated with the plane are printed.
Note: 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 requested block and assign them to a plane.
  • by programming: replace the call to iSubstBlock by a call to ..Plane in order to display the requested plane.

Changing plane in a report

The change of plane in a report must be done when printing the report. We recommend that you use ..Plane in one of the processes of report, blocks or controls.
// Opening process of the report
// Display the plane 2
MyReport..Plane = 2
The change of plane is immediate: only the controls associated with the plane are printed.
Note: 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 requested block and assign them to a plane.
  • by programming: replace the call to iSubstBlock by a call to ..Plane in order to display the requested 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 required version
  • Version 9
This page is also available for…
Comments
video planos
https://youtu.be/s0_5KlVhD2U
amarildo
Jul. 25 2018
Planos.. Treinamento
MyWindow..Plane=2

Treinamento

// BLOG COM VIDEO E EXEMPLOS

http://windevdesenvolvimento.blogspot.com.br/2017/07/aula-1220-windev-dicas-035-planos.html

https://www.youtube.com/watch?v=lF8V_iyd3RE

De matos
Jul. 24 2017