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

Version 3

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)