XBell

Syntax

XBell(display, percent)
      Display *display;
      int percent;

Arguments

display	Specifies the connection to the X server.
percent	Specifies the volume for the bell, which can range from \-100 to 100 inclusive.

Description

The XBell() function rings the bell on the keyboard on the specified display, if possible. The specified volume is relative to the base volume for the keyboard. If the value for the percent argument is not in the range \-100 to 100 inclusive, a BadValue error results. The volume at which the bell rings when the percent argument is nonnegative is:

base - [(base * percent) / 100] + percent

The volume at which the bell rings when the percent argument is negative is:

base + [(base * percent) / 100]

To change the base volume of the bell, use XChangeKeyboardControl().

XBell() 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

XAutoRepeatOff(), XAutoRepeatOn(), XChangeKeyboardControl(), XChangeKeyboardMapping(), XGetKeyboardControl(), XQueryKeymap(), XSetPointerMapping(), "Keyboard and Pointer Settings".

---

Christophe Tronche, [email protected]