moveFirst Method (JScript 5.6)
Resets the current item in the collection to the first item.
enumObj.moveFirst( )
Remarks
The required enumObj reference is any Enumerator object.
If there are no items in the collection, the current item is set to undefined.
Example
In following example, the moveFirst method is used to evaluate members of the Drives collection from the beginning of the list:
function ShowFirstAvailableDrive(){
var fso, s, e, x; //Declare variables.
fso = new ActiveXObject("Scripting.FileSystemObject");
e = new Enumerator(fso.Drives); //Create Enumerator object.
e.moveFirst(); //Move to first drive.
s = ""; //Initialize s.
do
{
x = e.item(); //Test for existence of drive.
if (x.IsReady) //See if it's ready.
{
s = x.DriveLetter + ":"; //Assign 1<SUP>st</SUP> drive letter to s.
break;
}
else
if (e.atEnd()) //See if at the end of the collection.
{
s = "No drives are available";
break;
}
e.moveNext(); //Move to the next drive.
}
while (!e.atEnd()); //Do while not at collection end.
return(s); //Return list of available drives.
}
Requirements
Applies To: Enumerator Object (JScript 5.6)
See Also
Reference
atEnd Method (JScript 5.6)
item Method (JScript 5.6)
moveNext Method (JScript 5.6)