CwMoveObjectForward
Sintassi:
call CwMoveObjectForward hObject
hObject (handle) Handle a un oggetto
Descrizione:
Questa procedura sposta l'oggetto riferito da "hObject" in avanti di una posizione.
In questo modo l'oggetto riferito da "hObject" scambia il suo posto con l'oggetto
che gli si trova davanti. Se non ci sono oggetti posti davanti a quello dato, la funzione non esegue alcuna operazione. Si noti che per un oggetto,
essere davanti a un altro non significa necessariamente che questi si debbano sovrapporre.
Esempio:
/* Sposta l'oggetto selezionato in avanti brutalmente. */
obj = CwGetSelectedObject()
if \CwIsHandleValid(obj) then exit
do while obj \= CwFindNextObject(0)
call CwMoveObjectForward obj
end
Note:
Questa procedura interferisce con le funzioni di ricerca di oggetti
CwFindFirstObject, CwFindLastObject, CwFindNextObject, CwFindPreviousObject,
CwFindDeeperObject e CwFindShallowerObject.
Spostare un oggetto mentre gli oggetti vengono elencati con CwGet{First,Next}Object
porterà a risultati impredicibili. Nel caso delle funzioni CwFind, l'ordine di
ricerca è garantito e basato sull'oggetto precedentemente fornito, per cui è
possibile predire se queste si comporteranno come ci si aspetta o meno.