NAME

XForceScreenSaver − turn the screen saver on or off. 

Synopsis

XForceScreenSaver(display, mode)
Display *display;
int mode;

Arguments

displaySpecifies a connection to an X server; returned from XOpenDisplay(). 

modeSpecifies 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 random 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 13, Other Programming Techniques. 

Errors

BadValue

See Also

XActivateScreenSaver(), XGetScreenSaver(), XResetScreenSaver(), XSetScreenSaver(). 

Copyright O’Reilly & Assoc.  —