Relayering allows you to manipulate the layers of controls in a dynamic fashion and shift controls relative to other controls on a card. This lesson shows two examples in which layering can be used.

We are using the test stack shown in this figure as a starting point to demonstrate how relayering works. The buttons b1, b2 and b3 occupy layers 1, 2 and 3 respectively. Layer 1 is the layer closest to the card with higher layers protruding closer towards the viewer.

In this example we are moving button b1 between buttons b2 and b3. We are using the following syntax to do this:

relayer button "b1" before button "b3"

We could also use the following syntax to complete the same operation:

relayer button "b1" after button "b2"

You can see how button b2 has seemingly moved onto the card.

This example demonstrates that you can also move controls relative to the card. We are using the following syntax to  move button b3 on to the card:

relayer button "b3" to back of card "Relayer"

Native controls are created in native layers and therefore other controls cannot be layer on top of them. Native layers are always on top.

Controls that are created in native layers are

• Android native button
• Browser widget
• iOS native button
• Mac native button
• Mac native single line field
• Map widget
• Any controls created with mobileControlCreate