ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / WLanguage properties / Properties associated with windows, pages and controls
  • Single Z-index
  • ZOrder modification
  • Limitations
  • Features specific to Tab controls
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
The ZOrder property defines the Z-order of an element. You can:
  • Get the Z-index of a control in a window or report. This Z-index is relative to the window or report. If the control is placed in a tab pane, the Z-index is set within the tab.
  • Set the Z-index 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-index 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-index 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-index 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-index 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-index will be equal to the number of controls present in the window or in the report block.
Remarks

Single Z-index

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

ZOrder modification

Changing the Z-index of a control may offset the position of the other controls (by 1).
If a field's ZOrder increases or decreases, only those fields whose altitude lies between the old and new field altitudes are modified: the altitude of these fields automatically decreases by 1.
For example, if a field's z-order is changed from 4 to 8, only fields with z-orders between 4 and 8 will be automatically modified: their z-order will decrease by 1 (e.g. field with z-order 5 will change to z-order 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 Text control.
  • Edit control.
  • Image control.
  • Check Box control.
  • Radio Button control.
  • List Box control.
  • Combo Box control.
  • TreeView control.
  • Tab control.
  • Table control.
  • Supercontrol.
WINDEVJavaUser code (UMC)

Features specific to Tab controls

If the window contains a Tab control:
  • The Tab control has a Z-index. This Z-order is relative to the window
  • The Z-index 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-index.
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 12/05/2024

Send a report | Local help