IsSwitchedOn (object)

Returns a boolean - true if the object is switched on.

This function simply reads the switchedon attribute of the object.