onplaystatechange Event
| Internet Development Index |
Fires when the Media Bar player changes its play state.
Syntax
Event property mediaBar.onplaystatechange = handler JScript only mediaBar.onplaystatechange = GetRef("handler") Visual Basic Scripting Edition (VBScript) 5.0 or later only Named script <SCRIPT FOR = mediaBar EVENT = onplaystatechange> Internet Explorer only
Event Information
Bubbles No Cancels No To invoke
- Attempt to play media content in the media player.
- Scan forward or backward in the currently playing media content.
- Pause or stop the currently playing media content.
Default action Initiates any action associated with this script.
Available Properties
Remarks
The Media Bar player's play state changes as it begins, pauses, or stops media playback, scans a stream forward or backward, and buffers or waits for streaming data. To handle events related to locating and opening media items, use onopenstatechange.
If multiple instances of the mediaBar behavior run concurrently, only one of them receives event notification, even though all instances have access to media item attributes and information about the open and play states. Developers are encouraged to avoid designs that employ multiple instances of the behavior.
Although the event object is theoretically available in event notifications from onopenstatechange and onplaystatechange, it does not contain or provide useful information if queried. Instead, event handlers should query the openState and playState properties to return player state information.
Example
In the following example, HTML in the Media Bar content area is updated with the media's play state information when the onplaystatechange event fires. Because the openState and playState properties return an integer, the function in this example accesses an array in order to return a text description. The array is not shown on this page, but you can see it by clicking the Show Me sample and viewing the source code.
<SCRIPT> . . . function play_state_handle() { // Return the play state as integer and access the array to return the text associated // with that integer div_Playstate.innerText += divMedia.playState + ' ' + play_array[divMedia.playState] + '<BR>' } . . . </SCRIPT> <BODY> <!-- In the Media Bar content area, the play state description text appears in divMedia. --> <DIV style="behavior:url(#default#mediaBar)" OnPlayStateChange="play_state_handle()" id="divMedia"></DIV> </BODY>This feature requires Microsoft® Internet Explorer 6 or later. Click the following icon to install the latest version. Then reload this page to view the sample.
Applies To
mediaBar
See Also
playState