Section 3: library functions
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…
XGetXCBConnection – get the XCB connection for an Xlib Display Syntax #include <X11/Xlib-xcb.h> xcb_connection_t *XGetXCBConnection(Display *dpy);Argumentsdpy Specifies the connection to the X server.DescriptionThe XGetXCBConnection function returns the XCB connection associated with an Xlib Display. Clients can use this XCB connection with functions from the XCB library, just as they would with an XCB connection created with…
XGetWindowProperty, XListProperties, XChangeProperty, XRotateWindowProperties, XDeleteProperty – obtain and change window properties Syntaxint XGetWindowProperty(Display *display, Window w, Atom property, long long_offset, long long_length, Bool delete, Atom req_type, Atom *actual_type_return, int *actual_format_return, unsigned long *nitems_return, unsigned long *bytes_after_return, unsigned char **prop_return); Atom *XListProperties(Display *display, Window w, int *num_prop_return); int XChangeProperty(Display *display, Window w, Atom property, Atom type,…
XGetWindowAttributes, XGetGeometry, XWindowAttributes – get current window attribute or geometry and current window attributes structure SyntaxStatus XGetWindowAttributes(Display *display, Window w, XWindowAttributes *window_attributes_return); Status XGetGeometry(Display *display, Drawable d, Window *root_return, int *x_return, int *y_return, unsigned int *width_return, unsigned int *height_return, unsigned int *border_width_return, unsigned int *depth_return);Argumentsborder_width_return Returns the border width in pixels. d Specifies the drawable,…
XAllocSizeHints, XSetWMNormalHints, XGetWMNormalHints, XSetWMSizeHints, XGetWMSizeHints, XSizeHints – allocate size hints structure and set or read a window’s WM_NORMAL_HINTS property SyntaxXSizeHints *XAllocSizeHints(void); void XSetWMNormalHints(Display *display, Window w, XSizeHints *hints); Status XGetWMNormalHints(Display *display, Window w, XSizeHints *hints_return, long *supplied_return); void XSetWMSizeHints(Display *display, Window w, XSizeHints *hints, Atom property); Status XGetWMSizeHints(Display *display, Window w, XSizeHints *hints_return, long *supplied_return,…
XSetWMProtocols, XGetWMProtocols – set or read a window’s WM_PROTOCOLS property SyntaxStatus XSetWMProtocols(Display *display, Window w, Atom *protocols, int count); Status XGetWMProtocols(Display *display, Window w, Atom **protocols_return, int *count_return);Argumentsdisplay Specifies the connection to the X server. count Specifies the number of protocols in the list. count_return Returns the number of protocols in the list. protocols Specifies…
XAllocSizeHints, XSetWMNormalHints, XGetWMNormalHints, XSetWMSizeHints, XGetWMSizeHints, XSizeHints – allocate size hints structure and set or read a window’s WM_NORMAL_HINTS property SyntaxXSizeHints *XAllocSizeHints(void); void XSetWMNormalHints(Display *display, Window w, XSizeHints *hints); Status XGetWMNormalHints(Display *display, Window w, XSizeHints *hints_return, long *supplied_return); void XSetWMSizeHints(Display *display, Window w, XSizeHints *hints, Atom property); Status XGetWMSizeHints(Display *display, Window w, XSizeHints *hints_return, long *supplied_return,…
XSetWMName, XGetWMName, XStoreName, XFetchName – set or read a window’s WM_NAME property Syntaxvoid XSetWMName(Display *display, Window w, XTextProperty *text_prop); Status XGetWMName(Display *display, Window w, XTextProperty *text_prop_return); int XStoreName(Display *display, Window w, char *window_name); Status XFetchName(Display *display, Window w, char **window_name_return);Argumentsdisplay Specifies the connection to the X server. text_prop Specifies the XTextProperty structure to be used….
XSetWMIconName, XGetWMIconName, XSetIconName, XGetIconName – set or read a window’s WM_ICON_NAME property Syntaxvoid XSetWMIconName(Display *display, Window w, XTextProperty *text_prop); Status XGetWMIconName(Display *display, Window w, XTextProperty *text_prop_return); int XSetIconName(Display *display, Window w, char *icon_name); Status XGetIconName(Display *display, Window w, char **icon_name_return);Argumentsdisplay Specifies the connection to the X server. icon_name Specifies the icon name, which should be…
XAllocWMHints, XSetWMHints, XGetWMHints, XWMHints – allocate window manager hints structure and set or read a window’s WM_HINTS property SyntaxXWMHints *XAllocWMHints(void); int XSetWMHints(Display *display, Window w, XWMHints *wmhints); XWMHints *XGetWMHints(Display *display, Window w);Argumentsdisplay Specifies the connection to the X server. w Specifies the window. wmhints Specifies the XWMHints structure to be used.DescriptionThe XAllocWMHints function allocates and…
XSetWMColormapWindows, XGetWMColormapWindows – set or read a window’s WM_COLORMAP_WINDOWS property SyntaxStatus XSetWMColormapWindows(Display *display, Window w, Window *colormap_windows, int count); Status XGetWMColormapWindows(Display *display, Window w, Window **colormap_windows_return, int *count_return);Argumentsdisplay Specifies the connection to the X server. colormap_windows Specifies the list of windows. colormap_windows_return Returns the list of windows. count Specifies the number of windows in the…