Media.durationString

The durationString property retrieves a String value indicating the duration of the current media item in HH:MM:SS format.

Syntax

player.currentMedia.durationString

Possible Values

This property is a read-only String.

Remarks

If this property is used with a media item other than the one specified in Player.currentMedia, it may not contain a valid value. If the media item is less than an hour long, the HH: portion of the return value is omitted.

To retrieve the value of this property, read access to the library is required. For more information, see Library Access.

Examples

The following JScript example uses Media.durationString to display the duration of the current media item as formatted text. An HTML DIV element named MediaInfo displays the duration information. The Player object was created with ID = "Player".

<!-- Create an event handler to update the display when
 the current media item changes. -->
<SCRIPT LANGUAGE = "JScript"  FOR = Player  EVENT = OpenStateChange(NewState)>

// Test whether the new media item is open.
if (NewState == 13){

   // Write the formatted duration string to the DIV region.
   MediaInfo.innerHTML = "Duration: " + Player.currentMedia.durationString;
}
</SCRIPT>

Requirements

Version
Windows Media Player version 7.0 or later.
DLL
Wmp.dll

See also

Media Object

Media.duration

Player.currentMedia

Settings.mediaAccessRights

Settings.requestMediaAccessRights