Action: Ifmoved(target, alarm ID, delay)

Related Actions: timer, randomtimer, lettimer, iffixed, ifmapped, ifnotfixed, ifnotmapped, ifnotmoved, exitevent
Related Events: alarm
See also: FKiSS, Events, Actions

ifmoved(target, alarm ID, delay)

First defined in: FKiSS2.1
If the object specified by target is not in its initial position on the current set (page), the ifmoved action sets the timer for an alarm. If a timer for that alarm is already counting down, the new delay time will replace it, resetting the alarm's timer.
Setting delay to zero will cancel the timer for that alarm, preventing the alarm from being activated.

target

In FKiSS2.1 to FKiSS3, target must be an object number.
In FKiSS4, target may be an object number or a variable representing an object number.

alarm ID

In FKiSS2.1, alarm ID must be an alarm ID number.
In FKiSS3, alarm ID may be an alarm ID number or a variable representing an alarm ID number.
In FKiSS4, alarm ID may also be a symbolic name representing an alarm or a variable representing an alarm ID number.

delay

In FKiSS2.1, delay must be a number representing the delay time in milliseconds.
In FKiSS3, delay may also be a variable representing the delay time in milliseconds.

Example:

;@ ifmoved(#5, 10, 1000)              ; If object 5 is not in its initial position, set alarm 10 to 1000 milliseconds
;@ ifmoved(VarObj, MyAlarm, VarDelay) ; If the object identified by VarObj is not in its initial position, set alarm MyAlarm to VarDelay milliseconds