item Method | Internet Development Index |
Retrieves an object from the specified collection.
Syntax
oItem = object.item( [iIndex])
Parameters
iIndex Optional. Integer that specifies the index 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. If a value is not specified, the default is 0.
Return Value
Returns a reference to the object located at the specified index in the collection.
Example
This example demonstrates how to use the item method to retrieve an object from a collection.
<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 TOPMARGIN=0 LEFTMARGIN=0 BGPROPERTIES="FIXED" BGCOLOR="#FFFFFF" LINK="#000000" VLINK="#808080" ALINK="#000000"> <t:media id="m1" begin="indefinite;" src="../../common/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>
Standards Information
This method is a Microsoft extension to Synchronized Multimedia Integration Language (SMIL) .
Applies To
activeElements, timeAll, timeChildren, playList
See Also
Introduction to HTML+TIME, activeElements