XForceScreenSaver

Syntax

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

Arguments

display Specifies the connection to the X server.
mode Specifies the mode that is to be applied. You can pass ScreenSaverActive or ScreenSaverReset.

Description

If the specified mode is ScreenSaverActive and the screen saver currently is deactivated, XForceScreenSaver() activates the screen saver even if the screen saver had been disabled with a timeout of zero. If the specified mode is ScreenSaverReset and the screen saver currently is enabled, XForceScreenSaver() deactivates the screen saver if it was activated, and the activation timer is reset to its initial state (as if device input had been received).

XForceScreenSaver() can generate a BadValue error.

Diagnostics

BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined by the argument's type is accepted. Any argument defined as a set of alternatives can generate this error.

See also

XSetScreenSaver(), XActivateScreenSaver(), XResetScreenSaver(), XGetScreenSaver(), "Screen Saver Control".
Christophe Tronche, ch@tronche.com