Syntax:
+[void] sysinfo.lightoff(String lighttarget, Int duration, Int fadeout)+
Description:
+The lightoff method switches the specified target light off for the specified duration.
Argument:
+lighttarget:
Defines which target light should be turned off. Use one of the supported target light properties to specify a target light.
+ +duration:
Defines the period during which the target light is switched off. The period is measured in milliseconds.
+After the duration expires, the light state of the target will be changed to whatever state was caused by the last infinite time duration call. If there has not been a previous infinite time duration call in a session, the default state determined by the inactivity timer (system backlight timeout) is used.
+If duration is lightinfiniteduration, the target light can be turned on only when some other light control method is called.
fadeout:
If true, target lights will not turn off instantly but fade-out smoothly instead. If false, target lights will be turned off immediately.
Note: All devices might not support fade-out, in which case the device will behave in its default manner.
+Return value:
+This method does not return a value.
+Example code:
+function callLightOff()
+{
+ // get the Embed element reference
+ var sysinfo = document.embeds[0];
+ /*********************
+ call lightoff() method, which turns off the light
+ of all displays and keyboard for 5 seconds of duration
+ and using fading out mode
+ *********************/
+ var target = sysinfo.lighttargetsystem;
+ var duration = 5000; // 5 seconds
+ sysinfo.lightoff(target, duration, true);
+}
+
+