ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage properties / Properties associated with windows, pages and controls
  • Single Z-order position
  • Changing the position in the Z-order
  • Limitations
  • Features specific to Tab controls
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 ZOrder property defines the Z-order of an element. You can:
  • Get the Z-order position of a control in a window or report. This Z-order position is relative to the window or report. If the control is placed in a tab pane, the Z-order position is set within the tab.
  • Set the Z-order position of a control (for example, define if the control is to be placed at the front or at the back of the z-order). The Z-order of a control can be set in relation to the Z-order position of another control in the window or report.
WEBDEV - Server code This property only applies to the controls found in a report.
// Depending on the value entered in the Radio Button control,
// one of the Image controls is displayed at the front
SWITCH RADIO_Image
CASE 1: IMG_Image_Car.ZOrder = 100
CASE 2: IMG_Image_Train.ZOrder = 100
CASE 3: IMG_Image_Plane.ZOrder = 100
END
Syntax

Getting the position of a control in the Z-order Hide the details

<Control Z-order> = <Control used>.ZOrder
<Control Z-order>: Integer
Z-order position between 1 and the total number of controls in the report block or the window.
  • 1 corresponds to the lowest position in the Z-order (back).
  • The total number of controls corresponds to the highest position in the Z-order (front).
<Control used>: Control name
Name of the control in the window or report.

Changing the Z-order position of a control Hide the details

<Control used>.ZOrder = <New control Z-order>
<Control used>: Control name
Name of the control in the window or report.
<New control Z-order>: Integer (greater than or equal to 1)
If the new Z-order position is greater than the number of controls in the window or report, the control will be placed at the front (on top of all controls). The real Z-order position will be equal to the number of controls present in the window or in the report block.
Remarks

Single Z-order position

Two controls in the same group have a unique Z-order position.

Changing the position in the Z-order

Changing the Z-order position of a control may offset the position of the other controls (by 1).
When the Z-order position of one control changes, it only affects the position of the controls between the initial and new Z-order positions: the Z-order position of these controls automatically decreases by 1.
For example, if the Z-order position of a control changes from 4 to 8, only the z-order position of the controls between 4 and 8 will change: their Z-order position will decrease by 1 (the control with a previous Z-order position of 5 will be set to 4).

Limitations

The ZOrder property applies only to controls in a window or report. This property cannot be used in windows, menus, table columns, etc.
Java The ZOrder property can only be used in the following controls:
  • Button control.
  • Static control.
  • Edit control.
  • Image control.
  • Check Box control.
  • Radio Button control.
  • List Box control.
  • Combo Box control.
  • TreeView control.
  • Tab control.
  • Table control.
  • Supercontrol.
Universal Windows 10 App The ZOrder property has no effect on HTML Display controls.
WINDEVJavaUser code (UMC)

Features specific to Tab controls

If the window contains a Tab control:
  • The Tab control has a Z-order position. This Z-order is relative to the window
  • The Z-order position of the controls placed in a tab pane is set within the Tab control. All the controls in the tab pane have a different Z-order position.
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 04/11/2023

Send a report | Local help