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
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.
// 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.
Universal Windows 10 App The ZOrder property has no effect on HTML Display controls.
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