activeTrack property

  • Article

Sets the active track or gets the active playItem object in the playList collection.

Syntax

JScript 
pPlayItem = object.activeTrack

 

Property values

Type: Object

Receives the active playItem object in the playList collection.

Remarks

When you use this property to set the active track in the playList, that track begins playing immediately.

If a script accesses this property on a playList that is not currently active, an error is returned. To prevent this error, the script should check the isActive property before attempting to read the activeTrack.

Examples

This example demonstrates how to retrieve a property of the current active track by using the activeTrack property.

Code example: http://samples.msdn.microsoft.com/workshop/samples/author/behaviors/asxProperties.htm

<HTML XMLNS:t="urn:schemas-microsoft-com:time">
<HEAD>
<?IMPORT namespace="t" implementation="#default#time2">
<TITLE>HTML+TIME playList Example</TITLE>

<LINK REL="stylesheet" HREF="/workshop/samples/samples.css" TYPE="text/css">


<STYLE>
    .time{ behavior: url(#default#time2);}
</STYLE>

<SCRIPT LANGUAGE="JScript">
function updateBtns()
{
  if (oMedia.currTimeState.isActive) {
    btnStart.disabled=true;
    btnNext.disabled=false;
    btnPrev.disabled=false;
    btnStop.disabled=false;
  }
  else {
    btnStart.disabled=false;
    btnNext.disabled=true;
    btnPrev.disabled=true;
    btnStop.disabled=true;
  }
}

function updateFields()
{
    oTitle.innerText = "Title: " + oMedia.playList.activeTrack.title;
    oAuthor.innerText = "Author: " + oMedia.playList.activeTrack.author;
    oAbstract.innerText = "Abstract: " + oMedia.playList.activeTrack.abstract;
    oCopyright.innerText = "Copyright: " + oMedia.playList.activeTrack.copyright;
    oFilename.innerText = "Filename: " + oMedia.playList.activeTrack.src;
}

function clearFields()
{
  oTitle.innerText = "Title: ";
  oAuthor.innerText = "Author: ";
  oAbstract.innerText = "Abstract: ";
  oCopyright.innerText = "Copyright: ";
  oFilename.innerText = "Filename: ";
}
</SCRIPT>
</HEAD>

<BODY onload="updateBtns()">


<t:MEDIA id="oMedia" src="short_3tracks.asx" begin="indefinite" timeAction="visibility"
onend="updateBtns();" ontrackchange="updateFields();"/>
<P>

<SPAN id="oTitle">Title:</SPAN><BR>
<SPAN id="oAuthor">Author:</SPAN><BR>
<SPAN id="oAbstract">Abstract:</SPAN><BR>
<SPAN id="oCopyright">Copyright:</SPAN><BR>
<SPAN id="oFilename">Filename:</SPAN><BR><BR>

<BUTTON id="btnStart" 
  onclick="oMedia.beginElement(); updateBtns();">
  Start
</BUTTON>

<BUTTON id="btnPrev"
  onclick="oMedia.playList.prevTrack();">
  Previous Track
</BUTTON>

<BUTTON id="btnNext" 
  onclick="oMedia.playList.nextTrack();">
  Next Track
</BUTTON>

<BUTTON id="btnStop"
  onclick="oMedia.endElement(); clearFields();">
  Stop
</BUTTON>

</BODY>
</HTML>

See also

playList

Reference

nextTrack

prevTrack

Conceptual

Introduction to HTML+TIME