Lingo Dictionary > O-R > persistent |  |

persistent

Syntax

    timeoutObject.persistent

Description

Object property; determines whether the given `timeoutObject` is removed from `the timeoutList` when the current movie stops playing. If `TRUE`, `timeoutObject` remains active. If `FALSE`, the timeout object is deleted when the movie stops playing. The default value is `FALSE`.

Setting this property to `TRUE` allows a timeout object to continue generating timeout events in other movies. This is useful when one movie branches to another with the `go to movie` command.

Example

This `prepareMovie` handler creates a timeout object that will remain active after the declaring movie stops playing:

    on prepareMovie
    	-- Make a timeout object that sends an event every 60 minutes.
    	timeout("reminder").new(1000 * 60 * 60, #handleReminder)
    	timeout("reminder").persistent = TRUE
    end

See also

`name (timeout property)`, `period`, `target`, `time (timeout object property)`, `timeout()`, `timeoutHandler`, `timeoutList`