currentTimeChanged

Typemessage
DictionaryLCS
LibraryLiveCode Script
Syntax
currentTimeChanged <pNewTime>
Associationsplayer
Summary

Sent to a player when the user switches to another frame.

Introduced1.0
Changes

The pNewTime parameter was introduced in version 2.0. In previous versions, the currentTimeChanged message did not have a parameter.

OSmac, windows, linux
Platformsdesktop, server
Parameters
NameTypeDescription
pNewTime

The number of the interval where the player is after the change.

Example
on currentTimeChanged theInterval -- display the time in a field
  put theInterval into field "Time Code"
end currentTimeChanged
RelatedKeyword: player
Property: callbacks, duration
Message: playStarted, playPaused, selectionChanged
Object: player
Glossary: property, player, message, frame, trap
Control Structure: pass
Description

The currentTimeChanged message is sent while the player is playing or when a user changes the current time in a player.

Handle the currentTimeChanged message if you want to do something when the user changes the current time in a player.

The user can change the current time by:

  • clicking the play button in the controller bar,
  • clicking in the controller bar,
  • dragging the controller bar scroller thumb,
  • using the arrow keys when the player is the active (focused) control,
  • using the scrubber control in the controller bar. (which is revealed by clicking the arrow buttons in the controller bar while holding the shift key down.)

Changing the player's currenttime property property by script does not trigger the sending of the currentTimeChanged message.

Changing the player's currenttime property property by script does not trigger the sending of the currentTimeChanged message.

Starting the player by script does trigger the sending of the currentTimeChanged message once it is playing.

The number of intervals per second is specified by the player's timeScale property. The total number of intervals is given in the player's duration property.

The actual process of changing the player's current time is not triggered by the currentTimeChanged message, so trapping the message and not allowing it to pass does not prevent the user from changing the player's current time manually.

Tagsmultimedia