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