#
CwMoveObjectBackward

### Syntax:

    call CwMoveObjectBackward hObject

            hObject         (handle) The handle referencing an object

### Description:

This procedure moves the given object "hObject" backward by one. That is, it makes "hObject" trade places with the object behind it. If there is no such object, nothing happens. Note that for an object to be behind another object does not mean that they have to overlap.

### Example:

    /* Move selected object to the back the hard way. */

    obj = CwGetSelectedObject()

    if \CwIsHandleValid(obj) then exit

    do while obj \= CwFindPreviousObject(0)
            call CwMoveObjectBackward obj
            end

### 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