Z-order position of a control

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Overview
Modifying the z-order position of a control
Modifying the z-order position of a control from the window editor or from the page editor
Modifying the z-order position of a control from the retort editor
To modify the z-order position of a control by programming
Note
Single z-order position

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Z-order position of a control

Overview

All controls found in a window (in a page or in a report) have a different z-order position. The z-order position of a control corresponds to the order of appearance of the control in relation to the plane of the window (or page or report).

For example:

Window displayed in the editor

Vertical section of the window

The z-order position is used to manage the superposition effects of several controls: if two controls are overlaid (two images for instance), the control displayed in the foreground will be the control with the highest z-order.

Modifying the z-order position of a control

The z-order position of a control can be modified:

from the window editor or from the page editor.
from the report editor.
by programming.

Modifying the z-order position of a control from the window editor or from the page editor

To modify the z-order position of a control from the window editor or from the page editor:

Select the requested control.
Select "Control" and choose the action to perform:On the "Modification" pane, in the "Alignment" group, choose the action to perform:
- to position a control on the highest z-order position: select "Foreground".to position a control on the highest z-order position: expand "Move up" and select "Foreground".
- to position a control on the lowest z-order position: select "Background".to position a control on the lowest z-order position: expand "Move down" and select "Background".
- to increase the z-order position of a control: select "Move up".to increase the z-order position of a control: expand "Move up" and select "Move up".
- to reduce the z-order position of a control: select "Move down".to reduce the z-order position of a control: expand "Move down" and select "Move down".

Note: The icon bar can also be used to modify the z-order position of a control:

Modifying the z-order position of a control from the retort editor

To modify the z-order position of a control from the report editor:

Select the requested control.
Select "Control .. Z-order" and choose the action to perform:On the "Modification" pane, in the "Alignment" group, choose the action to perform:
- to position a control on the highest z-order position: select "Foreground".to position a control on the highest z-order position: expand "Move up" and select "Foreground".
- to position a control on the lowest z-order position: select "Background".to position a control on the lowest z-order position: expand "Move down" and select "Background".
- to increase the z-order position of a control: select "Move up".to increase the z-order position of a control: expand "Move up" and select "Move up".
- to reduce the z-order position of a control: select "Move down".to reduce the z-order position of a control: expand "Move down" and select "Move down".

Note: To modify the z-order position of a control, you also have the ability to use the icon bar or the popup menu of the control (right mouse click).

Icon bar

To modify the z-order position of a control by programming

Use ..ZOrder on the controls found in a window or report.

Note

Single z-order position

All the controls belonging to the same window (or to the same report) have a different z-order position.

Special cases:

Control in a window belonging to a tab, a supercontrol or a toolbar
If the window contains a tab:
- A z-order position is assigned to the tab. This z-order position is given in relation to the window.
- The z-order position of the controls found in the tab is given in relation to the tab. All the controls found in the tab have a different z-order position.
  The supercontrols and the toolbars behave like the tabs.
Planes of a window
If the window is using several planes, the z-order position of controls is global to all planes.
See The planes for more details.