item method

Retrieves the playItem object at the specified index from the current playList collection.

Syntax

var retval = playList.item(varIndex);

Parameters

  • varIndex [in, optional]
    Type: VARIANT

    An Variant of type Integer or String that specifies the index or title of the object to retrieve from the collection. The first object in the collection is located at index position 0, and the last object in the collection is located at position length minus 1.

Return value

Type: ITIMEPlayItem

Receives the active playItem object in the playList collection.

Examples

This example demonstrates how to use the item method to retrieve an object from a collection.

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

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

<STYLE>
    .time{ behavior: url(#default#time2);}
</STYLE>
<SCRIPT LANGUAGE="JavaScript">
var m2; //another media object
//...
function setActiveTrack(){
    if(itemNumber.value=="" || 
            (itemNumber.value<1 || itemNumber.value>5) || 
            (isFinite(itemNumber.value)==false)){
        alert('Must enter a valid track number!\nPlease re-enter your choice (1-5).');
        itemNumber.value='';
        itemNumber.focus();
        return;
    }else{
        m2 = m1.playList.item(itemNumber.value-1); //index starts at 0
        updateFields();
    }
}
...
</SCRIPT>
</HEAD>

<BODY>

<t:media id="m1" begin="indefinite;" 
   src="/workshop/samples/author/behaviors/media/media.asx" />

<span id="title1">Title:</span><BR>
<span id="author1">Author:</span><BR>
<span id="abstract1">Abstract:</span><BR>
<span id="copyright1">Copyright:</span><BR>
<span id="index1">Index: </span><BR><BR>

Enter track number (1-5): <input type="text" name="itemNumber" value="" size="2"><BR><BR>

<BUTTON id="b0" onclick="m1.beginElement();setActiveTrack();">Start</BUTTON>
<BUTTON id="b3" onclick="m1.endElement();emptyFields();">Stop</BUTTON>
<BR><BR>

</BODY>
</HTML>

See also

playList

Reference

activeElements

Conceptual

Introduction to HTML+TIME