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