Action: Ifnotmoved(target, alarm ID, delay)

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

ifnotmoved(target, alarm ID, delay)

First defined in: FKiSS2.1
If the object specified by target is in its initial position on the current set (page), the ifnotmoved 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.
Note: If an object moves away from its initial position then moves back to the initial position, ifnotmoved still sets the alarm as though the object never moved.

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:

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