Xlib − C Language X Interface

Xlib − C LibraryX11, Release 6.7 DRAFTand is either PlaceOnTop or PlaceOnBottom. Ifitis PlaceOnTop, the subwindow should beon top of all siblings. If it is PlaceOnBottom, the subwindow should be below all siblings.10.11.2. ConfigureRequest EventsThe X server can report ConfigureRequest events to clients wanting information about when adifferent client initiates a configure window request on any child of a specified window. The configurewindow request attempts to reconfigure a window’s size, position, border, and stackingorder. The X server generates this event whenever adifferent client initiates a configure windowrequest on a window bycalling XConfigureWindow, XLowerWindow, XRaiseWindow,XMapRaised, XMoveResizeWindow, XMoveWindow, XResizeWindow, XRestackWindows,or XSetWindowBorderWidth.To receive ConfigureRequest events, set the SubstructureRedirectMask bit in the event-maskattribute of the window. ConfigureRequest events are generated when a ConfigureWindowprotocol request is issued on a child window byanother client. For example, suppose a clientapplication calls XLowerWindow to lower a window. Ifyou had selected SubstructureRedirectMaskon the parent window and if the override-redirect attribute of the window isset toFalse, the X server reports a ConfigureRequest event to you and does not lower the specifiedwindow.The structure for this event type contains:typedef struct {int type; /* ConfigureRequest */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 parent;Window window;int x, y;int width, height;int border_width;Window above;int detail; /* Above, Below, TopIf, BottomIf, Opposite */unsigned long value_mask;}XConfigureRequestEvent;The parent member is set to the parent window. The window member is set to the window whosesize, position, border width, and/or stacking order is to be reconfigured. The value_mask memberindicates which components were specified in the ConfigureWindow protocol request. The correspondingvalues are reported as given inthe request. The remaining values are filled in fromthe current geometry of the window, except in the case of above (sibling) and detail (stack-mode),which are reported as None and Above, respectively, ifthey are not given inthe request.10.11.3. MapRequest EventsThe X server can report MapRequest events to clients wanting information about a differentclient’s desire to map windows. A window isconsidered mapped when a map window requestcompletes. The Xserver generates this event whenever adifferent client initiates a map windowrequest on an unmapped window whose override_redirect member is set to False. Clients initiatemap window requests by calling XMapWindow, XMapRaised, or XMapSubwindows.225