Objects Reference

This section contains information about scripting elements used with Windows Sidebar, a hosting platform for Sidebar Gadgets delivered in Microsoft Windows Vista.

Objects

System.Contact

The System.Contact object type exposes properties associated with a contact.

Note  Objects of type System.Contact can only be accessed through the Contacts Collection.

System.ContactManager

Exposes a collection of System.Contact objects.

Note  Objects of type System.Contact can only be accessed through the Contacts Collection.

System.Debug

Exposes a method for use in debugging Sidebar gadget script.

System.Diagnostics.EventLog

Returns the contents of the specified Event Viewer event log.

System.Environment

Exposes methods and properties used to determine current user session machine characteristics.

System.Gadget

Defines methods, events, and properties that are used to specify gadget configuration options in the Sidebar environment.

System.Gadget.Flyout

Used in a Sidebar gadget to specify flyout prompt properties.

System.Gadget.Settings

Checks to see if there are stored settings for a gadget, such as settings that are saved from an earlier session of a particular gadget instance.

System.Gadget.Settings.ClosingEvent

Defines properties and methods to identify and specify cancellation handlers for the gadget settings process.

System.Gadget.Sidebar

Exposes members associated with Sidebar docking.

System.Gadget.SideShow

Exposes properties, methods and events for managing Sidebar gadget behavior on SideShow devices.

System.Machine

Exposes properties and collections that identify the computer's processor and memory characteristics.

System.Machine.CPU

Exposes properties associated with a CPU.

Note   Objects of type System.Machine.CPU can only be accessed through the CPUs Collection.

System.Machine.PowerStatus

Exposes properties and events for determining and managing power status.

System.MessageStore

Exposes a collection of System.MessageStoreFolder object types.

System.MessageStoreFolder

Exposes a collection of System.MessageStoreMessage object types.

System.MessageStoreMessage

Exposes properties associated with messages.

System.Network.Wireless

The object properties and events enable a gadget to detect wireless network interface settings on the Windows system that the gadget is running on.

System.Shell

Enables a Sidebar gadget to use properties and objects from the Windows shell.

System.Shell.Folder

Enables a Sidebar gadget to mimic Windows Explorer file management operations, such as copying, moving, and obtaining item information within folders.

System.Shell.Item

Exposes properties and methods associated with Windows shell items.

Note  The System.Shell.Item object type can only be accessed through the Items Collection.

System.Shell.RecycleBin

Enables a Sidebar gadget to determine the Recycle Bin behaviors and settings, for example, file count and folder count.

System.ShellDrive

Enables a Sidebar gadget to access properties and methods associated with an instance of a drive object to use in a Sidebar gadget script. The object is created with the System.Shell.drive method. Drive characteristics of the retrieved object, for example, type of drive or volume label, can be determined.

System.Sound

Enables a gadget to determine sound characteristics such as volume and the location that a sound file should be played from.

System.Time

Exposes members associated with system time characteristics.

System.Time.timeZone

Exposes members associated with time zone characteristics.

Note   Objects of type System.Time.timeZone can only be accessed through the timeZones Collection or the System.Time.currentTimeZone() method.