XForceScreenSaver()XForceScreenSaver()NameXForceScreenSaver – 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.
DescriptionXForceScreenSaver() resets or activates the screen saver.
If the specified mode is ScreenSaverActive and the screen saver cur‐
rently 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 random
change take place to save the phosphors.
If the specified mode is ScreenSaverReset and the screen saver cur‐
rently 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 con‐
tents.
For more information on the screen saver, see Volume One, Chapter 15,
Other Programming Techniques.
Errors
BadValue
See AlsoXActivateScreenSaver(), XGetScreenSaver(), XResetScreenSaver(),
XSetScreenSaver().
Xlib - Screen Saver XForceScreenSaver()