Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XDEVICEBELL(3)							XDEVICEBELL(3)

NAME
       XDeviceBell - ring a bell on a device supported through the input
       extension

SYNOPSIS
       #include	<X11/extensions/XInput.h>

       Status XDeviceBell( Display *display,
			   XDevice *device,
			   XID feedbackclass,
			   XID feedbackid,
			   int percent);
       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(3), XBell(3)

				  03/09/2013			XDEVICEBELL(3)

NAME | SYNOPSIS | DESCRIPTION | DIAGNOSTICS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=XDeviceBell&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help