NAME

XBell − ring the bell (Control G). 

Synopsis

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

Arguments

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

percentSpecifies the volume for the bell, relative to the base volume set with XChangeKeyboardControl().  Possible values are  − 100 (off), through 0 (base volume), to 100 (loudest) inclusive. 

Description

Rings the bell on the keyboard at a volume relative to the base volume, if possible.  percent can range from  − 100 to 100 inclusive (else a BadValue error).  The volume at which the bell is rung when percent is nonnegative is:

volume = base - [(base * percent) / 100] + percent and when percent is negative:

volume = base + [(base * percent) / 100] To change the base volume of the bell, set the bell_percent variable of XChangeKeyboardControl(). 

Errors

BadValuepercent <  − 100 or percent >100. 

See Also

XAutoRepeatOff(), XAutoRepeatOn(), XChangeKeyboardControl(), XGetDefault(), XGetKeyboardControl(), XGetPointerControl(). 

Copyright O’Reilly & Assoc.  —