PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Overview
  • Implementation: Enabling the management of planes
  • How to proceed?
  • Delayed plane loading
  • Special cases
  • Operations in the editor
  • Assigning one or more controls to one or more planes
  • Selecting the plane displayed in the editor
  • Changing plane by programming
  • Changing plane in an element
  • Effects when changing plane
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 controls of an element. A plane is a "layer" of an element. Each element can be made of several planes.
WEBDEV proposes the management of planes for the following elements:
  • the pages
  • the internal pages
  • the cells
  • the layout areas
  • the popups
  • the supercontrols
  • the control templates,
  • the page templates.
The controls can be positioned on different planes. A single plane can be displayed at a time in the page editor and when running the site.
Each element control can:
  • 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).
Implementation: Enabling the management of planes

How to proceed?

To use the planes in WEBDEV, the management of planes must be enabled for the requested element:
  1. Display the description window of the element.
  2. In the "GUI" tab, check "Enable the management of planes".
  3. Validate the description window of the element.
  4. The planes are available for the element. If the display of planes is allowed in the editor, the digit 1 used to identify the first plane appears at the top right of the element.
    Note: To manage the display of the plane number in the editor, in the "Display" pane, in the "View (all controls)" group, check "Planes".
When the management of planes is enabled, you have the ability to create the requested controls and to associate them with the different planes.

Delayed plane loading

When enabling planes, you have the ability to check "Delayed loading of plane content" (option available from version 220052). When enabling planes, you have the ability to check "Delayed loading of plane content" (option available from version 220052).
This option is used to optimize the load of data found in the planes. Indeed, if the planes contain a lot of data to display, the page load may be quite long. You have the ability to optimize by loading the data when the relevant plane is displayed: this is called "delayed loading".
If the option "Delayed loading of plane content" is checked when enabling planes, two new processes are associated with the element:
  • Delayed loading of a plane (Server) in AJAX.
  • Delayed loading of a plane (Browser).
In these processes, you have the ability to use ..Plane to find out the active plane. This allows you to only run the process used to initialize the controls found in the relevant plane.
Example of code:
// Code for delayed loading (server) of CELL_VARIOUS
SWITCH CELL_VARIOUS..Plane
CASE 1 // Displaying the list of customers
  ProcLoadCustomerTable()
CASE 2 // Displaying the orders of selected customer
  CustomerID is int = TABLE_Customer.Col_CustomerNum
  ProcLoadCustomerOrd(CustomerID)
CASE 3 // Order details
OrdNum is int = TABLE_Order.Col_OrderNum
ProcLoadOrderDetails(OrdNum)
END

Special cases

  • Looper control: You have the ability to use planes for each repetition. All you have to do is create a cell for each repetition. This cell contains the planes to display. A "Plane" attribute is used to manage the number of the plane displayed.
  • Table control: You have the ability to use planes in a container column, by using a cell for example.
  • Zoning:
    • If the planes are managed at page level, the zoning is defined for each plane.
    • Several planes can be used in each layout area.
  • Scrolling Banner control: The Scrolling Banner control is using the planes to display the different banner elements. In this case, the management of planes is specific. See The Scrolling Banner control for more details.
Operations in the editor

Assigning one or more controls to one or more planes

Case 1: Creating controls:
When creating a control on an element containing planes, the created control is automatically associated with the visible plane.
Case 2: Associating existing controls with 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 the selection.
    • "Associate with a plane" from the popup menu of the control.
  3. In the window that is displayed, choose:
    • one of the available planes.
    • several planes (to do so, keep the [CTRL] key down while selecting planes).
  4. Validate.
Notes:
  • A control positioned on an element containing planes is always associated with a plane.
    There is no plane 0, used to make a control visible regardless of the plane displayed. To manage this case, all you have to do is define different areas, for example an area containing no plane and an area containing planes.
  • If a control is associated with several planes, it automatically become stackable.
  • The number of planes is unlimited. However, the page 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 the control ("GUI" tab, "Plane" option).
  • When assigning a control to a plane, the plane to which the control is assigned is automatically displayed in the editor.
  • 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:
  1. Select (if necessary) the element for which the planes must be displayed.
  2. Press [Page up] and [Page down]. These keys are used to display the different planes of the current element (or the different planes of the parent control of the selection).
If the display of planes is allowed in the editor, the number of the current plane is displayed at the top right of the element.
Changing plane by programming
..Plane is used to:
  • find out and change the current plane of an element.
  • find out the plane associated with a control.

Changing plane in an element

Changing plane in an element can be performed at any time. A button is often used to change plane.
Example:
// Switch to plane 4 for adding orders
PAGE_CRM.CELL_OrdCell..Plane = 4
The change of plane is immediate: only the controls associated with the plane are displayed.

Effects when changing plane

The change of plane can be done with effects. you have the ability to define effects:
  • for the element that manages the planes. In the "Style" tab, you must:
    • select the "Effects" element.
    • click "Add an effect".
    • select an effect for changing plane and configure it with the "Details" button. You have the ability to specify how the effect will be triggered (change of plane, go to previous plane, ...)
  • for the elements found in the plane, by managing specific effects for the appearance or disappearance of controls. In the "Style" tab, you must:
    • select the "Effects" element.
    • click "Add an effect".
    • select an appearance or disappearance effect and configure it with the "Details" button: several animations are proposed.
Caution: The effects operate only if the page is not re-displayed. In order for the effect to be visible, ..Plane must be called in browser code or in Ajax server code.
Related Examples:
WW_Rewali Complete examples (WEBDEV): WW_Rewali
[ + ] This example is a site for travel booking.

It proposes travels at very attractive prices.
You have the ability to choose the travel duration, the start dates, then validate the purchase until the payment via Paypal.

It is using the "scrolling banner" control and the planes.
WW_Wizard Training (WEBDEV): WW_Wizard
[ + ] WEBDEV allows you to create your own Web wizards, via the WLanguage PageDisplayDialog function that is used to display a page in a modal way.

This allows you to establish a dialog with the user.
To go from a wizard plane to another one, all you have to do is use the concept of plane found in WEBDEV.
Minimum required version
  • Version 22
Comments
Click [Add] to post a comment