Section 3: library functions
XISetFocus, XIGetFocus – set or get the device’s focus. Synopsis#include <X11/extensions/XInput2.h>Status XISetFocus( Display *display, int deviceid, Window focus, Time time);Status XIGetFocus( Display *display, Window *focus_return);display Specifies the connection to the X server.deviceid Specifies the device whose focus is to be queried or changed.focus The new focus window.focus_return Returns the current focus window.time A valid timestamp…
XISetClientPointer, XIGetClientPointer – set or get the ClientPointer device. Synopsis#include <X11/extensions/XInput2.h>XISetClientPointer( Display *display, Window win, int deviceid);Bool XIGetClientPointer( Display *display, Window win, int *device);display Specifies the connection to the X server.win Specifies a window belonging to the client. May be None.deviceid Specifies the ClientPointer device.DescriptionThe ClientPointer is the device that is percieved to be the…
XIQueryDevice, XIFreeDeviceInfo – get information about devices. Synopsis#include <X11/extensions/XInput2.h>XIDeviceInfo* XIQueryDevice( Display *display, int deviceid, int *ndevices_return);XIFreeDeviceInfo( XIDeviceInfo *info);deviceid Specifies the device to query or XIAllDevices or XIAllMasterDevices.display Specifies the connection to the X server.ndevices_return Returns the number of devices returned.info A list of device XIDeviceInfo structs to be freed.DescriptionThe XIQueryDevice returns information about one or…
XIChangeProperty, XIGetProperty, XIDeleteProperty – change, retrieve or delete a device’s property. Synopsis#include <X11/extensions/XInput2.h>void XIChangeProperty( Display* dpy, int deviceid, Atom property, Atom type, int format, int mode, unsigned char *data, int num_items)void XIDeleteProperty( Display *dpy, int deviceid, Atom property)Status XIGetProperty( Display *dpy, int deviceid, Atom property, long offset, long length, Bool delete_property, Atom type, Atom *type_return,…
XIDefineCursor, XIUndefineCursor – define device cursors. Synopsis#include <X11/extensions/XInput2.h>int XIDefineCursor( Display *display, int deviceid, Window win, Cursor cursor);int XIUndefineCursor( Display *display, int deviceid, Window win);cursor Specifies the cursor that is to be displayed or None.deviceid Specifies the device whose cursor is to change.display Specifies the connection to the X server.win Specifies the window.DescriptionIf a cursor is…
XIChangeProperty, XIGetProperty, XIDeleteProperty – change, retrieve or delete a device’s property. Synopsis#include <X11/extensions/XInput2.h>void XIChangeProperty( Display* dpy, int deviceid, Atom property, Atom type, int format, int mode, unsigned char *data, int num_items)void XIDeleteProperty( Display *dpy, int deviceid, Atom property)Status XIGetProperty( Display *dpy, int deviceid, Atom property, long offset, long length, Bool delete_property, Atom type, Atom *type_return,…
XIChangeHierarchy – change the device hierarchy. Synopsis#include <X11/extensions/XInput2.h>Status XIChangeHierarchy( Display *display, XIAnyHierarchyChangeInfo *changes, int num_changes);display Specifies the connection to the X server.num_changes Specifies the number of elements in changes.changes Specifies the changes to be made.DescriptionXIChangeHierarchy modifies the device hierarchy by creating or removing master devices or changing the attachment of slave devices. If num_changes is…
XIBarrierReleasePointer, XIBarrierReleasePointers – allow pointer movement across a pointer barrier Synopsis#include <X11/extensions/XInput2.h>int XIBarrierReleasePointer( Display *display, int deviceid, PointerBarrier barrier, BarrierEventID eventid);int XIBarrierReleasePointers( Display *display, XIBarrierReleasePointerInfo *barriers, int num_barriers);display Specifies the connection to the X server.deviceid Specifies the device allowed to move across the barrier.barrier Specifies the barrier.eventid Specifies the unique event ID for this barrier…
XIBarrierReleasePointer, XIBarrierReleasePointers – allow pointer movement across a pointer barrier Synopsis#include <X11/extensions/XInput2.h>int XIBarrierReleasePointer( Display *display, int deviceid, PointerBarrier barrier, BarrierEventID eventid);int XIBarrierReleasePointers( Display *display, XIBarrierReleasePointerInfo *barriers, int num_barriers);display Specifies the connection to the X server.deviceid Specifies the device allowed to move across the barrier.barrier Specifies the barrier.eventid Specifies the unique event ID for this barrier…
XAddHost, XAddHosts, XListHosts, XRemoveHost, XRemoveHosts, XSetAccessControl, XEnableAccessControl, XDisableAccessControl, XHostAddress, XServerInterpretedAddress – control host access and host control structure Syntaxint XAddHost(Display *display, XHostAddress *host); int XAddHosts(Display *display, XHostAddress *hosts, int num_hosts); XHostAddress *XListHosts(Display *display, int *nhosts_return, Bool state_return); int XRemoveHost(Display *display, XHostAddress *host); int XRemoveHosts(Display *display, XHostAddress *hosts, int num_hosts); int XSetAccessControl(Display *display, int mode); int…
XGravityEvent – GravityNotify event structure StructuresThe structure for GravityNotify events contains: typedef struct { int type; /* GravityNotify */ unsigned long serial; /* # of last request processed by server */ Bool send_event; /* true if this came from a SendEvent request */ Display *display; /* Display the event was read from */ Window event; Window window; int x, y; } XGravityEvent; When you receive this event, the structure…
XGraphicsExposeEvent, XNoExposeEvent – GraphicsExpose and NoExpose event structures StructuresThe structures for GraphicsExpose and NoExpose events contain: typedef struct { int type; /* GraphicsExpose */ unsigned long serial; /* # of last request processed by server */ Bool send_event; /* true if this came from a SendEvent request */ Display *display; /* Display the event was read from */ Drawable drawable; int x, y; int width, height; int count; /* if nonzero,…
XGrabServer, XUngrabServer – grab the server Syntaxint XGrabServer(Display *display); int XUngrabServer(Display *display);Argumentsdisplay Specifies the connection to the X server.DescriptionThe XGrabServer function disables processing of requests and close downs on all other connections than the one this request arrived on. You should not grab the X server any more than is absolutely necessary. The XUngrabServer function…
XGrabPointer, XUngrabPointer, XChangeActivePointerGrab – grab the pointer Syntaxint XGrabPointer(Display *display, Window grab_window, Bool owner_events, unsigned int event_mask, int pointer_mode, int keyboard_mode, Window confine_to, Cursor cursor, Time time); int XUngrabPointer(Display *display, Time time); int XChangeActivePointerGrab(Display *display, unsigned int event_mask, Cursor cursor, Time time);Argumentsconfine_to Specifies the window to confine the pointer in or None. cursor Specifies the…
XGrabKeyboard, XUngrabKeyboard – grab the keyboard Syntaxint XGrabKeyboard(Display *display, Window grab_window, Bool owner_events, int pointer_mode, int keyboard_mode, Time time); int XUngrabKeyboard(Display *display, Time time);Argumentsdisplay Specifies the connection to the X server. grab_window Specifies the grab window. keyboard_mode Specifies further processing of keyboard events. You can pass GrabModeSync or GrabModeAsync. owner_events Specifies a Boolean value that…
XGrabKey, XUngrabKey – grab keyboard keys Syntaxint XGrabKey(Display *display, int keycode, unsigned int modifiers, Window grab_window, Bool owner_events, int pointer_mode, int keyboard_mode); int XUngrabKey(Display *display, int keycode, unsigned int modifiers, Window grab_window);Argumentsdisplay Specifies the connection to the X server. grab_window Specifies the grab window. keyboard_mode Specifies further processing of keyboard events. You can pass GrabModeSync…
XGrabDeviceKey, XUngrabDeviceKey – grab/ungrab extension input device Keys Synopsis#include <X11/extensions/XInput.h>int XGrabDeviceKey( Display *display, XDevice *device, unsigned int key, unsigned int modifiers, XDevice *modifier_device, Window grab_window, Bool owner_events, unsigned int event_count, XEventClass *event_list, int this_device_mode, int other_devices_mode);int XUngrabDeviceKey( Display *display, XDevice *device, unsigned int key, unsigned int modifiers, XDevice *modifier_device, Window grab_window);display Specifies the connection to…
XGrabDeviceButton, XUngrabDeviceButton – grab/ungrab extension input device buttons Synopsis#include <X11/extensions/XInput.h>int XGrabDeviceButton( Display *display, XDevice *device, unsigned int button, unsigned int modifiers, XDevice* modifier_device, Window grab_window, Bool owner_events, unsigned int event_count, XEventClass *event_list, int this_device_mode, int other_devices_mode);int XUngrabDeviceButton( Display *display, XDevice *device, unsigned int button, unsigned int modifiers, XDevice* modifier_device, Window grab_window);display Specifies the connection to…
XGrabDevice, XUngrabDevice – grab/release the specified extension device Synopsis#include <X11/extensions/XInput.h>int XGrabDevice( Display *display, XDevice* device, Window grab_window, Bool owner_events, int event_count, XEventClass *event_list, int this_device_mode, int other_devices_mode, Time time);int XUngrabDevice( Display *display, XDevice *device, Time time);display Specifies the connection to the X server.device Specifies the device to be grabbed or released.grab_window Specifies the id of…
XGrabButton, XUngrabButton – grab pointer buttons Syntaxint XGrabButton(Display *display, unsigned int button, unsigned int modifiers, Window grab_window, Bool owner_events, unsigned int event_mask, int pointer_mode, keyboard_mode, Window confine_to, Cursor cursor); int XUngrabButton(Display *display, unsigned int button, unsigned int modifiers, Window grab_window);Argumentsbutton Specifies the pointer button that is to be grabbed or released or AnyButton. confine_to Specifies…