Section 3: library functions
XGrabButton, XUngrabButton – grab pointer buttons Syntax int 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); Arguments button Specifies the pointer button that is to be grabbed or released or…
XGetXCBConnection – get the XCB connection for an Xlib Display Syntax #include <X11/Xlib-xcb.h> xcb_connection_t *XGetXCBConnection(Display *dpy); Arguments dpy Specifies the connection to the X server. Description The 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…
XGetWindowProperty, XListProperties, XChangeProperty, XRotateWindowProperties, XDeleteProperty – obtain and change window properties Syntax int 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…
XGetWindowAttributes, XGetGeometry, XWindowAttributes – get current window attribute or geometry and current window attributes structure Syntax Status 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); Arguments border_width_return Returns the border width in pixels. d…
XAllocSizeHints, XSetWMNormalHints, XGetWMNormalHints, XSetWMSizeHints, XGetWMSizeHints, XSizeHints – allocate size hints structure and set or read a window’s WM_NORMAL_HINTS property Syntax XSizeHints *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…
XSetWMProtocols, XGetWMProtocols – set or read a window’s WM_PROTOCOLS property Syntax Status XSetWMProtocols(Display *display, Window w, Atom *protocols, int count); Status XGetWMProtocols(Display *display, Window w, Atom **protocols_return, int *count_return); Arguments display 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…
XAllocSizeHints, XSetWMNormalHints, XGetWMNormalHints, XSetWMSizeHints, XGetWMSizeHints, XSizeHints – allocate size hints structure and set or read a window’s WM_NORMAL_HINTS property Syntax XSizeHints *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…
XSetWMName, XGetWMName, XStoreName, XFetchName – set or read a window’s WM_NAME property Syntax void 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); Arguments display Specifies the connection to the X server. text_prop Specifies the XTextProperty structure…
XSetWMIconName, XGetWMIconName, XSetIconName, XGetIconName – set or read a window’s WM_ICON_NAME property Syntax void 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); Arguments display Specifies the connection to the X server. icon_name Specifies the icon name,…
XAllocWMHints, XSetWMHints, XGetWMHints, XWMHints – allocate window manager hints structure and set or read a window’s WM_HINTS property Syntax XWMHints *XAllocWMHints(void); int XSetWMHints(Display *display, Window w, XWMHints *wmhints); XWMHints *XGetWMHints(Display *display, Window w); Arguments display Specifies the connection to the X server. w Specifies the window. wmhints Specifies the XWMHints structure to be used. Description…
XSetWMColormapWindows, XGetWMColormapWindows – set or read a window’s WM_COLORMAP_WINDOWS property Syntax Status XSetWMColormapWindows(Display *display, Window w, Window *colormap_windows, int count); Status XGetWMColormapWindows(Display *display, Window w, Window **colormap_windows_return, int *count_return); Arguments display 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…
XSetWMClientMachine, XGetWMClientMachine – set or read a window’s WM_CLIENT_MACHINE property Syntax void XSetWMClientMachine(Display *display, Window w, XTextProperty *text_prop); Status XGetWMClientMachine(Display *display, Window w, XTextProperty *text_prop_return); Arguments display Specifies the connection to the X server. text_prop Specifies the XTextProperty structure to be used. text_prop_return Returns the XTextProperty structure. w Specifies the window. Description The XSetWMClientMachine convenience…
XGetVisualInfo, XMatchVisualInfo, XVisualIDFromVisual, XVisualInfo – obtain visual information and visual structure Syntax XVisualInfo *XGetVisualInfo(Display *display, long vinfo_mask, XVisualInfo *vinfo_template, int *nitems_return); Status XMatchVisualInfo(Display *display, int screen, int depth, int class, XVisualInfo *vinfo_return); VisualID XVisualIDFromVisual(Visual *visual); Arguments class Specifies the class of the screen. depth Specifies the depth of the screen. display Specifies the connection to…
XSetTransientForHint, XGetTransientForHint – set or read a window’s WM_TRANSIENT_FOR property Syntax int XSetTransientForHint(Display *display, Window w, Window prop_window); Status XGetTransientForHint(Display *display, Window w, Window *prop_window_return); Arguments display Specifies the connection to the X server. w Specifies the window. prop_window Specifies the window that the WM_TRANSIENT_FOR property is to be set to. prop_window_return Returns the WM_TRANSIENT_FOR…
XSetTextProperty, XGetTextProperty – set and read text properties Syntax void XSetTextProperty(Display *display, Window w, XTextProperty *text_prop, Atom property); Status XGetTextProperty(Display *display, Window w, XTextProperty *text_prop_return, Atom property); Arguments display Specifies the connection to the X server. property Specifies the property name. text_prop Specifies the XTextProperty structure to be used. text_prop_return Returns the XTextProperty structure. Description…
XPutImage, XGetImage, XGetSubImage – transfer images Syntax int XPutImage(Display *display, Drawable d, GC gc, XImage *image, int src_x, int src_y, int dest_x, int dest_y, unsigned int width, unsigned int height); XImage *XGetImage(Display *display, Drawable d, int x, int y, unsigned int width, unsigned int height, unsigned long plane_mask, int format); XImage *XGetSubImage(Display *display, Drawable d,…
XSetSelectionOwner, XGetSelectionOwner, XConvertSelection – manipulate window selection Syntax int XSetSelectionOwner(Display *display, Atom selection, Window owner, Time time); Window XGetSelectionOwner(Display *display, Atom selection); int XConvertSelection(Display *display, Atom selection, Atom target, Atom property, Window requestor, Time time); Arguments display Specifies the connection to the X server. owner Specifies the owner of the specified selection atom. You can…
XSelectExtensionEvent, XGetSelectedExtensionEvents – select extension events, get the list of currently selected extension events Synopsis #include <X11/extensions/XInput.h> XSelectExtensionEvent( Display *display, Window w, XEventClass *event_list, int event_count); XGetSelectedExtensionEvents( Display *display, Window w, int *this_client_event_count_return, XEventClass **this_client_event_list_return, int *all_clients_event_count_return, XEventClass **all_clients_event_list_return); display Specifies the connection to the X server. w Specifies the window whose events you are…
XSetScreenSaver, XForceScreenSaver, XActivateScreenSaver, XResetScreenSaver, XGetScreenSaver – manipulate the screen saver Syntax int XSetScreenSaver(Display *display, int timeout, int interval, int prefer_blanking, int allow_exposures); int XForceScreenSaver(Display *display, int mode); int XActivateScreenSaver(Display *display); int XResetScreenSaver(Display *display); int XGetScreenSaver(Display *display, int *timeout_return, int *interval_return, int *prefer_blanking_return, int *allow_exposures_return); Arguments allow_exposures Specifies the screen save control values. You can pass…
XAllocStandardColormap, XSetRGBColormaps, XGetRGBColormaps, XStandardColormap – allocate, set, or read a standard colormap structure Syntax XStandardColormap *XAllocStandardColormap(void); void XSetRGBColormaps(Display *display, Window w, XStandardColormap *std_colormap, int count, Atom property); Status XGetRGBColormaps(Display *display, Window w, XStandardColormap **std_colormap_return, int *count_return, Atom property); Arguments display Specifies the connection to the X server. count Specifies the number of colormaps. count_return Returns…