item method
Retrieves an object from the specified collection by index.
Syntax
var retval = activeElements.item(varIndex);
Parameters
varIndex [in, optional]
Type: VARIANTAn Variant of type Integer that specifies the index or name 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
Type: Variant
Returns a reference to the object located at the specified index in the 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
Reference
Conceptual