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.

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, ...