Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

xkbgetdevicebuttonactions(3) [x11r4 man page]

XkbGetDeviceButtonActions(3)					   XKB FUNCTIONS				      XkbGetDeviceButtonActions(3)

NAME

       XkbGetDeviceButtonActions - Query the button actions associated with an X Input Extension device

SYNOPSIS

       Status XkbGetDeviceButtonActions ( dpy, device_info, all_buttons, first_button, num_buttons )
	     Display * dpy;
	     XkbDeviceInfoPtr device_info;
	     Bool all_buttons;
	     unsigned int first_button;
	     unsigned int num_buttons;

ARGUMENTS

       - dpy  connection to X server

       - device_info
	      structure to update with results

       - all_buttons
	      True => get information for all buttons

       - first_button
	      number of first button for which info is desired

       - num_buttons
	      number of buttons for which info is desired

DESCRIPTION

       XkbGetDeviceButtonActions  queries  the	server	for  the  desired  button information for the device indicated by the device_spec field of
       device_info and waits for a reply. If successful, XkbGetDeviceButtonActions backfills the button actions (btn_acts  field  of  device_info)
       for only the requested buttons, updates the name, type, supported, and unsupported fields, and returns Success.

       all_buttons,  first_button  and	num_buttons  specify  the device buttons for which actions should be returned. Setting all_buttons to True
       requests actions for all device buttons; if all_buttons is False, first_button and num_buttons specify a range of buttons for which actions
       are requested.

       If a compatible version of Xkb is not available in the server or the Xkb extension has not been properly initialized, XkbGetDeviceButtonAc-
       tions returns BadAccess. If allocation errors occur, a BadAlloc status is returned. If the specified device  (device_info->device_spec)	is
       invalid,  a  BadKeyboard  status  is returned. If the device has no buttons, a BadMatch status is returned. If first_button and num_buttons
       specify illegal buttons, a BadValue status is returned.

DIAGNOSTICS

       BadAccess      The Xkb extension has not been properly initialized

       BadAlloc       Unable to allocate storage

       BadKeyboard    The device specified was not a valid core or input extension device

       BadMatch       A compatible version of Xkb was not available in the server or an argument has correct type  and	range,	but  is  otherwise
		      invalid

       BadValue       An argument is out of range

X Version 11							   libX11 1.2.1 				      XkbGetDeviceButtonActions(3)

Check Out this Related Man Page

XkbSetDeviceButtonActions(3)					   XKB FUNCTIONS				      XkbSetDeviceButtonActions(3)

NAME

       XkbSetDeviceButtonActions - Change only the button actions for an input extension device

SYNTAX

       Bool XkbSetDeviceButtonActions (Display *dpy, XkbDeviceInfoPtr device, unsigned int first_button, unsigned int num_buttons);

ARGUMENTS

       - dpy  connection to X server

       - device
	      structure defining the device and modifications

       - first_button
	      number of first button to update, 0 relative

       - num_buttons
	      number of buttons to update

DESCRIPTION

       XkbSetDeviceButtonActions  assigns  actions  to	the  buttons of the device specified in device_info->device_spec.  Actions are assigned to
       num_buttons buttons beginning with first_button and are taken from the actions specified in device_info->btn_acts.

       If the server does not support assignment of Xkb actions to extension device buttons, XkbSetDeviceButtonActions has no effect  and  returns
       False.  If  the	device	has  no  buttons  or  if  first_button	or num_buttons specify buttons outside of the valid range as determined by
       device_info->num_btns, the function has no effect and returns False. Otherwise, XkbSetDeviceButtonActions sends a request to the server	to
       change the actions for the specified buttons and returns True.

       If  the	actual	request  sent  to the server involved illegal button numbers, a BadValue protocol error is generated. If an invalid device
       identifier  is  specified  in  device_info->device_spec,  a  BadKeyboard  protocol  error  results.  If	the  actual  device  specified	in
       device_info->device_spec does not contain buttons and a request affecting buttons is made, a BadMatch protocol error is generated.

DIAGNOSTICS

       BadKeyboard    The device specified was not a valid core or input extension device

       BadMatch       A  compatible  version  of  Xkb  was not available in the server or an argument has correct type and range, but is otherwise
		      invalid

       BadValue       An argument is out of range

X Version 11							   libX11 1.5.0 				      XkbSetDeviceButtonActions(3)
Man Page