ZOrder (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

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
Change of z-order
Limitations

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

ZOrder (Property)

In french: Altitude

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.

Example

See additional examples

// Selon la valeur saisie dans le champ Sélecteur, 
// un des champs Image est affiché au premier-plan 
SWITCH SEL_Image
	CASE 1: IMG_Image_Voiture.Altitude = 100
	CASE 2: IMG_Image_Train.Altitude = 100
	CASE 3: IMG_Image_Avion.Altitude = 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.

Change of z-order

Changing the Z-index of a control may offset the position of the other controls (by 1).

If a field's z-order increases or decreases, only those fields whose z-order lies between the field's old z-order and its new z-order are modified: the z-order of these fields automatically decreases by 1.
For example, if a field's altitude is changed from 4 to 8, only fields whose altitude is between 4 and 8 will be automatically modified: their altitude will decrease by 1 (field altitude 5 will be changed to altitude 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.