moveFirst, méthode

Article
08/21/2008

Mise à jour : novembre 2007

Place l'élément en cours dans un objet Enumerator en première position dans la liste.

function moveFirst()

Notes

Si la collection ne contient aucun élément, l'élément en cours est considéré undefined.

Exemple

Dans l'exemple suivant, la méthode moveFirst est utilisée pour évaluer des membres de la collection Drives à partir du début de la liste :

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.
}