#
CwMoveObjectInFrontOfObject

### Syntax:

    call CwMoveObjectInFrontOfObject hObj1, hObj2

            hObj1           (handle) The handle referencing the first object

            hObj2           (handle) The handle referencing the second object

### Description:

This procedure moves the first given object "hObj1" in front of the second object "hObj2". Note that for an object to be in front of another object does not mean that they have to overlap.

### Example:

    w1 = CwCreateEffect("Rectangle", "Color Fade")
    call CwSetPosition w1, 5.5, 4.25, 1, 4, 0, 0

    w2 = CwCreateEffect("Rectangle", "Solid Color")
    call CwSetPosition w2, 5.5, 4.25, 4, 1, 0, 0

    say 'Moving'
    call CwMoveObjectBehindObject w2, w1

    say 'Moving'
    call CwMoveObjectInFrontOfObject w2, w1

### Remarks:

This procedure will interfere with the object-searching functions CwFindFirstObject, CwFindLastObject, CwFindNextObject, CwFindPreviousObject, CwFindDeeperObject and CwFindShallowerObject. Moving an object while listing objects with CwGet{First,Next}Object will yield unpredictable results. In the case of the CwFind functions, search order is guaranteed and based on the previous given object, so it is possible to predict whether or not they will behave as expected.

Functions by NAME | Index | Functions by PURPOSE