This function sets a string as the device status. The string "message" is displayed in the Status screen. This appears on the web page and the local device list. This can be used to display the status of special devices like thermostats and weather stations. Note that this does not affect the actual X10 status for the device, which can be accessed by DeviceValue.
The text string can also contain HTML code, so you can add affects to the status like changing its color or making it scroll. See the example below to create some status using the marquee and blink HTML tags. Note the marquee tag is only supported in Internet Explorer and the blink tag is only supported in Netscape.
Parameter: device
Type: string
Description: This is the house code and unit code or device code of the
device, such as "A1" or "q17".
Parameter: message
Type: string
Description: This is the status string for the device, such as "72
degrees".
Parameter: reset
Type: boolean
Description: If this is set to TRUE,
the device change date/time will be updated (normally a string change
will not update the device last change date/time).
None.
sub main()
hs.SetDeviceString "A1", Motion Detected", True
' add some HTML to the text to create a scrolling status
hs.SetDeviceString "A2", "<MARQUEE><blink><b>Motion Detected</MARQUEE> </b></blink>"
end sub