relayer

Typecommand
DictionaryLCS
LibraryLiveCode Script
Syntax
relayer <control> {before | after} <layer> <index>
relayer <control> {before | after} control <target>
relayer <control> {before | after} <owner>
relayer <control> to {front | back} of <layer> <index>
relayer <control> to {front | back} of control <target>
relayer <control> to {front | back} of <owner>
Summary

Aids the manipulation of layers.

Introduced6.0
OSmac, windows, linux, ios, android
Platformsdesktop, server, mobile
Parameters
NameTypeDescription
control

The target control is the given control.

layer

The target control is the control with layer index.

index
target
owner

The target control is the owner of the control.

Example
relayer button "b1" after button "b2" -- bring button b1 to front
relayer button "b1" to back of card "testCard" -- send button b1 to the back of card testCard
RelatedKeyword: control
Property: tabGroupBehavior, relayerGroupedControls, layer
Command: group, ungroup
Function: intersect, number, mouseControl
Description

Use the relayer command to aid the manipulation of layers.

Use the relayer command move a control relative to a target in a number of ways. The relayer command can only be used within a card. Attempts to relayer controls from one card or another stack would throw an exception.

When using "before" the owner of the control becomes the owner of the target and is inserted before the target. The layer of the control becomes the layer of the target and the target and all subsequent controls shift up one. When using "after" the owner of the control becomes the owner of the target and is inserted after the target. The layer of the control becomes one greater than the layer of the last child of the target and all subsequent controls sift one up. When using "front" the owner of the control becomes the owner of the target and is inserted after the last child of the target (only valid if target is a container). When using "back" the owner of the control becomes the owner of the target and is inserted before the first child of the target (only valid if target is a container).