1XDeviceBell(3)                    X FUNCTIONS                   XDeviceBell(3)
2
3
4

NAME

6       XDeviceBell  -  ring  a  bell  on  a device supported through the input
7       extension
8

SYNTAX

10       Status XDeviceBell(Display *display, XDevice  *device,  XID  *feedback‐
11              class, XID *feedbackid, int *percent);
12

ARGUMENTS

14       display     Specifies the connection to the X server.
15
16       device      Specifies the device with which the bell is associated.
17
18       feedbackclass
19                   Specifies  the class of the feedback with which the bell is
20                   associated.
21
22       feedbackid  Specifies the id of the feedback with  which  the  bell  is
23                   associated.
24
25       percent     Specifies  the volume in the range -100 to 100 at which the
26                   bell should be rung.
27

DESCRIPTION

29       The XDeviceBell request causes the server to ring a bell on the  speci‐
30       fied feedback of the specified device, if possible.  The specified vol‐
31       ume is relative to the base volume for the bell.  If an invalid  device
32       is  specified,  a  BadDevice error will be returned.  The feedbackclass
33       and feedbackid parameters contain values returned by  an  XGetFeedback‐
34       Control request and uniquely identify the bell to ring.  If a feedback‐
35       class is specified that does not support a bell, or  if  a  nonexistent
36       feedbackid is specified, or a percent value is specified that is not in
37       the range -100 to 100, a BadValue error will be returned.
38
39       The volume at which the bell is rung when the percent argument is  non‐
40       negative is:
41
42              base - [(base * percent) / 100] + percent
43
44       The  volume  at which the bell rings when the percent argument is nega‐
45       tive is:
46
47              base + [(base * percent) / 100]
48
49       To change the base volume of the bell, use XChangeFeedbackControl.
50
51       XDeviceBell can generate a BadDevice or a BadValue error.
52

DIAGNOSTICS

54       BadDevice   An invalid device was specified.  The specified device does
55                   not exist, or has not been opened by this client via XOpen‐
56                   InputDevice.
57
58       BadValue    An invalid feedbackclass, feedbackid, or percent value  was
59                   specified.
60

SEE ALSO

62       XChangeFeedbackControl(3), XBell(3)
63       Programming With Xlib
64
65
66
67X Version 11                      libXi 1.1.1                   XDeviceBell(3)
Impressum