The second parameter of the copyHere() method takes an optional flag argument, which can be a combination of the following values:

To move files instead of copying them, use the moveFile() method, like in the following example, which moves all the files in folder1 to folder2:

   var destFolder = System.Shell.itemFromPath("C:\folder2");   var sourceFolder = System.Shell.itemFromPath("C:\folder1");   //---moves all the files in folder1 into folder2---   while (sourceFolder.SHFolder.Items.count>0) {      var item = sourceFolder.SHFolder.Items.item(0);      destFolder.SHFolder.moveHere( item, 16 + 256 + 512 );   }

You can also create a new folder; here's a code snippet that does so in C:folder1:

   var sourceFolder = System.Shell.itemFromPath("C:\folder1");   sourceFolder.SHFolder.newFolder("New Documents",0);

The following code displays the number of items contained within the C:folder1 folder:

   var sourceFolder = System.Shell.itemFromPath("C:\folder1");   var result = document.getElementById("result");   //---get info about itself---   var folder = sourceFolder.SHFolder.Self;   //--displays how many items in the folder---   result.innerHTML = folder.SHFolder.Items.count;

System.Shell.Item
The System.Shell.Item object returns detailed information about an item in the shell (such as files, folders, and shortcuts).

The code in Listing 4 shows you how to display the attributes of each file located in folder1.

The invokeVerb() method performs a specified action on a file. For example, the verb Open opens a file with its associated program. The following code first checks to see if an item's name ends with the .txt extension and opens it if it does (Notepad launches by default):

      if (item.name.indexOf(".txt") != -1) {         item.invokeVerb("Open");      }

Some commonly used verbs are Open, Edit, New, Print, and Show. You can find out which verbs are applicable for a file type by right-clicking on a file type in Windows Explorer and then viewing its list of applicable actions (see Figure 1).

Figure 1. View the Verbs: Find which verbs are applicable for a file type by right-clicking on a file type in Windows Explorer.

?

Figure 2. Metadata: The keys are listed in the Description section of the Details tab.

The metadata() method returns the metadata of an item based on the key (such as Title, Subject, Tags, Categories, Comments, and so on) specified. For example, the following code shows the Title metadata for a PowerPoint file:

      if (item.name.indexOf(".pptx") != -1) {         var metaData = item.metadata("Title");         result.innerHTML += metaData;      }

You can obtain the list of keys for a particular file type by right-clicking a file and selecting Properties. On the Details tab, the keys are listed in the Description section (see Figure 2). Common metadata keys are Title, Subject, Tags, Categories, and Comments.

System.Shell.RecycleBin
The System.Shell.RecycleBin object enables you to programmatically manipulate the Recycle Bin on your computer.

Here's a code example that shows you how to display the number of files and folders in the Recycle Bin, as well as the current size of the Recycle Bin:

         var result = document.getElementById("result");         result.innerHTML = "fileCount: " +            System.Shell.RecycleBin.fileCount + "
" +            "folderCount: " +            System.Shell.RecycleBin.folderCount + "
" +            "sizeUsed: " +            System.Shell.RecycleBin.sizeUsed + "KB";

Figure 3. The Recycle Bin Properties Dialog: The inline code example displays the Recycle Bin Properties dialog.

The following code example first displays the Recycle Bin Properties dialog (see Figure 3), followed by deleting an item (by moving it into the Recycle Bin). Finally, it asks the user if he wants to empty the Recycle Bin:

         //---shows the recycle bin status---         System.Shell.RecycleBin.showRecycleSettings();         //---delete a particular file (move to recycle bin)---         System.Shell.RecycleBin.deleteItem("c:\folder1\pic1.bmp")         //---empties the recycle bin---         System.Shell.RecycleBin.emptyAll();

The System.Shell.RecycleBin object has one event, onRecycleBinChanged, which allows script commands within a gadget to be run when the contents of the Recycle Bin are modified, such as when files, folders, or links being added or deleted from the set of items currently stored in the Recycle Bin.

The onRecycleBinChanged event fires whenever the content in the Recycle Bin is modified. The following code shows you how to wire an event handler to handle the onRecycleBinChanged event:

      System.Shell.RecycleBin.onRecycleBinChanged = RecycleBinChanged;      function RecycleBinChanged()      {         var result = document.getElementById("result");         result.innerHTML = "Recycle Bin Changed";      }

System.Shell.Drive
The System.Shell.Drive object enables you to obtain detailed information about a drive.

The code in Listing 5 shows you how you to retrieve detailed information about the C: drive.

The driveType property returns one of the following values:

Sounds
If your gadget needs to play system sounds or sound files, use the System.Sound object.

The beep() method generates a simple beep tone on the system's speakers, while the playSound() method plays a specified sound file:

    System.Sound.beep();    System.Sound.playSound(       "\windows\media\Windows Critical Stop.wav");

Time and Time Zones
You can obtain information about the different time zones using the following objects:

• System.Time
• System.Time.TimeZone

System.Time
The System.Time object enables you to obtain time information for the current system. It exposes a System.Time.timezones collection of System.Time.TimeZone objects.

Here's how you can obtain the collection of System.Time.TimeZone objects:

         var timeZones = System.Time.timeZones;

The System.Time object has only one method, getLocalTime(), which returns the local time based on the specified time zone. It also has only one property, currentTimeZone, which returns the current time zone as a System.Time.TimeZone object.

The following example shows you how you can display the current time in the current time zone:

         var result = document.getElementById("result");         var timeZone = System.Time.currentTimeZone;         result.innerHTML = "Local Time: " +                System.Time.getLocalTime(timeZone);

Figure 4. Time Zones: Retrieving all the details of the various time zones available.

System.Time.TimeZone
The System.Time.TimeZone object contains detailed information about a specific time zone. The following example shows you how to retrieve all the details of the various time zones available (see Figure 4 for the output):

var result = document.getElementById("result");         var timeZones = System.Time.timeZones;         for (var i=0; i" +                     "Bias: " + oTimeZone.bias + "
" +                    "Display Name: " + oTimeZone.displayName + "
" +                    "DST Bias: " + oTimeZone.DSTBias + "
" +                    "DST Date: " + oTimeZone.DSTDate + "
" +                    "Standard Bias: " + oTimeZone.standardBias + "
" +                    "Standard Date: " + oTimeZone.standardDate + "
" +                    "Standard Display Name: " +                   oTimeZone.standardDisplayName + "
";                 }

Vista's Potential
Now that you've examined the various objects exposed by Windows Sidebar, your gadget should be capable of harnessing all the additional functionalities available in Windows Vista.