XVisibilityEvent(3X)                         XVisibilityEvent(3X)



NAME
     XVisibilityEvent - structure for VisibilityNotify events

DESCRIPTION
     XVisibilityEvent is a structure for VisibilityNotify events.
     This structure is defined as follows.

     typedef struct {
       int type;     /* VisibiltyNotify */
       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 window;
       int state;
     } XVisibilityEvent;

     When this event is received, the structure members  are  set
     as follows.

     The type member is set to the event type constant name  that
     uniquely  identifies it.  For example, when the X server re-
     ports a GraphicsExpose event to  a  client  application,  it
     sends an XGraphicsExposeEvent structure with the type member
     set to GraphicsExpose.  The  display  member  is  set  to  a
     pointer   to  the  display  the  event  was  read  on.   The
     send_event member is set to TRUE if the event  came  from  a
     SendEvent  protocol  request.  The serial member is set from
     the serial number reported in the protocol but expanded from
     the  16-bit  least-significant  bits to a full 32-bit value.
     The window member is set to the window that is  most  useful
     to  toolkit  dispatchers, which, in this case, is the window
     whose visibility state changes.

     The state member is set to the state of the  window's  visi-
     bility and can be VisibilityUnobscured,
     VisibilityPartiallyObscured, or
     VisibilityFullyObscured.  The X  server  ignores  all  of  a
     window's subwindows when determining the visibility state of
     the window and processes
     VisibilityNotify events according to the following:

          When the window changes state from partially  obscured,
          fully  obscured,  or  not viewable to viewable and com-
          pletely unobscured, the X server  generates  the  event
          with the state member of the XVisibilityEvent structure
          set to VisibilityUnobscured.

          When the window changes state from  viewable  and  com-
          pletely unobscured or not viewable to viewable and par-



November, 1990                                                  1

XVisibilityEvent(3X)                         XVisibilityEvent(3X)



          tially obscured, the X server generates the event  with
          the  state member of the XVisibilityEvent structure set
          to VisibilityPartiallyObscured.

          When the window changes state from  viewable  and  com-
          pletely unobscured, viewable and partially obscured, or
          not viewable to viewable  and  fully  obscured,  the  X
          server generates the event with the state member of the
          XVisibilityEvent structure set to
          VisibilityFullyObscured.

SEE ALSO
     XAnyEvent(3X), XButtonEvent(3X), XCreateWindowEvent(3X),
     XCirculateEvent(3X), XCirculateRequestEvent(3X),
     XColormapEvent(3X), XConfigureEvent(3X),
     XConfigureRequestEvent(3X), XCrossingEvent(3X),
     XDestroyWindowEvent(3X), XErrorEvent(3X), XExposeEvent(3X),
     XFocusChangeEvent(3X), XGraphicsExposeEvent(3X),
     XGravityEvent(3X), XKeymapEvent(3X), XMapEvent(3X),
     XMapRequestEvent(3X), XPropertyEvent(3X),
     XReparentEvent(3X), XResizeRequestEvent(3X),
     XSelectionClearEvent(3X), XSelectionEvent(3X),
     XSelectionRequestEvent(3X), XUnmapEvent(3X)

     Xlib - C Language Interface































2                                                  November, 1990