ZOrder (Property)

Find out the z-order position of control in a window or in a report. This z-order position is given in relation to the window or to the report. If the control is positioned on a tab, the z-order position is given in relation to the tab.
Modify the z-order position of a control (for example, define whether the control must be displayed in the foreground or in the background). The z-order postion of a control can be specified in relation to the z-order postion of another control in the window or in the report.

This property can only be used to find out the z-order position of a control.

Versions 16 and later

This property is now available for Windows Phone applications.

New in version 16

This property is now available for Windows Phone applications.

Versions 17 and later

This property is now available for the window controls in the iPhone/iPad applications.

New in version 17

This property is now available for the window controls in the iPhone/iPad applications.

Versions 18 and later

This property is now available in Windows Store apps mode.

This property is now available for the report controls in the iPhone/iPad applications.

New in version 18

This property is now available in Windows Store apps mode.

This property is now available for the report controls in the iPhone/iPad applications.

This property is now available in Windows Store apps mode.

This property is now available for the report controls in the iPhone/iPad applications.

Versions 20 and later

This property is now available for the Table controls in the Android applications and in the iPhone/iPad applications.

New in version 20

This property is now available for the Table controls in the Android applications and in the iPhone/iPad applications.

Versions 21 and later

This property is now available in Universal Windows 10 App mode.

New in version 21

This property is now available in Universal Windows 10 App mode.

Example

See additional examples

// Depending on the value entered in the Radio Button control,
// one of the Image controls is displayed in the foreground
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

Finding out the z-order position of a control Hide the details

<Z-order position of control> = <Control name>..ZOrder

<Z-order position of control>: Integer

Z-order position included between 1 and the total number of controls found in the report block or in the window block.
The value 1 corresponds to the lowest z-order position (background).
The total number of controls corresponds to the highest z-order position (foreground).

<Control name>: Character string (with or without quotes)

Name of the report control.

Modifying the z-order position of a control Hide the details

<Control name>..ZOrder = <New Z-order position of control>

<Control name>: Character string (with or without quotes)

Name of the control found in the window or in the report.

<New Z-order position of control>: 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 positioned in the foreground (on top of all the controls). Its actual z-order position will be equal to the number of controls found in the window or in the report.

Remarks

Single z-order position

Two controls belonging to the same group have a single z-order position.

Modifying the z-order position

When the z-order position of a control is modified, the z-order position of the other controls may also be modified (by 1).

If the z-order position of the control increases or decreases, only the controls whose z-order position is included between the former z-order position and the new z-order position are modified: the z-order position of these controls is automatically reduced by 1.
For example, if the z-order position of a control changes from 4 to 8, only the controls whose z-order position is included between 4 and 8 will be automatically modified: their z-order position will be reduced by 1 (the control whose previous z-order position was 5 will now have a z-order position of 4).

Limits

..ZOrder only applies to the controls found in a window or in a report. This property cannot be used with the windows, menus, table columns, ...

..ZOrder has no effect on the HTML controls.

Specific features with the Tab controls

If the window contains a Tab control:

A z-order position is assigned to the Tab control. This z-order position is given in relation to the window.
The z-order position of the controls found in the tab pane is given in relation to the Tab control. All the controls found in the tab pane have a different z-order position.