XDeviceBell
Section: X FUNCTIONS (3X11)
Updated: Release 5
Index
Return to Main Contents
NAME
XDeviceBell - ring a bell on a device supported through the input extension
SYNTAX
Status XDeviceBell(display, device, feedbackclass, feedbackid, percent)
Display *display;
XDevice *device;
XID *feedbackclass;
XID *feedbackid;
int *percent;
ARGUMENTS
- display
-
Specifies the connection to the X server.
- device
-
Specifies the device with which the bell is associated.
- feedbackclass
-
Specifies the class of the feedback with which the bell is associated.
- feedbackid
-
Specifies the id of the feedback with which the bell is associated.
- percent
-
Specifies the volume in the range -100 to 100 at which the bell should be rung.
DESCRIPTION
The XDeviceBell request causes the server to ring a bell on the
specified feedback of the specified device, if possible.
The specified volume is relative to the base volume for the bell.
If an invalid device is specified,
a BadDevice error will be returned. The feedbackclass and feedbackid
parameters contain values returned by an XGetFeedbackControl request
and uniquely identify the bell to ring. If a feedbackclass is specified that
does not support a bell, or if a nonexistent feedbackid is specified,
or a percent value is specified that is not in the range -100 to 100,
a BadValue error will be returned.
The volume at which the bell is rung 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 XChangeFeedbackControl.
XDeviceBell can generate a BadDevice or a BadValue
error.
DIAGNOSTICS
- BadDevice
-
An invalid device was specified. The specified device does not exist, or has
not been opened by this client via XOpenInputDevice.
- BadValue
-
An invalid feedbackclass, feedbackid, or percent value was specified.
SEE ALSO
XChangeFeedbackControl(3X),
XBell(3X)
Programming With Xlib
Index
- NAME
-
- SYNTAX
-
- ARGUMENTS
-
- DESCRIPTION
-
- DIAGNOSTICS
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 07:02:32 GMT, May 19, 2025