#
CwMoveObjectForward

### Syntax:

    call CwMoveObjectForward hObject

            hObject         (handle) The handle referencing an object

### Description:

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

### Example:

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

    obj = CwGetSelectedObject()

    if \CwIsHandleValid(obj) then exit

    do while obj \= CwFindNextObject(0)
            call CwMoveObjectForward 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