XForceScreenSaver() XForceScreenSaver()
Name
XForceScreenSaver - turn the screen saver on or off.
Synopsis
XForceScreenSaver(display, mode)
Display *display;
int mode;
Arguments
display Specifies a connection to an X server; returned from XOpenDisplay().
mode Specifies whether the screen saver is active or reset. The possible modes are: ScreenSaverActive or ScreenSaverReset.
Description
XForceScreenSaver() resets or activates the screen saver.
If the specified mode is ScreenSaverActive and the screen saver currently is disabled, the screen saver is activated, even if the screen
saver had been disabled by calling XSetScreenSaver() with a timeout of zero (0). This means that the screen may go blank or have some ran-
dom change take place to save the phosphors.
If the specified mode is ScreenSaverReset and the screen saver currently is enabled, the screen is returned to normal, the screen saver is
deactivated and the activation timer is reset to its initial state (as if device input had been received). Expose events may be generated
on all visible windows if the server cannot save the entire screen contents.
For more information on the screen saver, see Volume One, Chapter 15, Other Programming Techniques.
Errors
BadValue
See Also
XActivateScreenSaver(), XGetScreenSaver(), XResetScreenSaver(), XSetScreenSaver().
Xlib - Screen Saver XForceScreenSaver()
