XtAddEventHandler(3Xt)                     XtAddEventHandler(3Xt)



NAME
     XtAddEventHandler, XtAddRawEventHandler,
     XtRemoveEventHandler,   XtRemoveRawEventHandler  -  add  and
     remove event handlers

SYNOPSIS
     void XtAddEventHandler(w, event-mask, nonmaskable, proc,
     client-data)
     Widget w;
     EventMask event-mask;
     Boolean nonmaskable;
     XtEventHandler proc;
     XtPointer client-data;

     void XtAddRawEventHandler(w, event-mask, nonmaskable, proc,
     client-data)
     Widget w;
     EventMask event-mask;
     Boolean nonmaskable;
     XtEventHandler proc;
     XtPointer client-data;

     voidXtRemoveEventHandler(w, event-mask, nonmaskable, proc,
     client-data)
     Widget w;
     EventMask event-mask;
     Boolean nonmaskable;
     XtEventHandler proc;
     XtPointer client-data;

     void XtRemoveRawEventHandler(w, event-mask, nonmaskable,
     proc, client-data)
     Widget w;
     EventMask event-mask;
     Boolean nonmaskable;
     XtEventHandler proc;
     XtPointer client-data;


















November, 1990                                                  1

XtAddEventHandler(3Xt)                     XtAddEventHandler(3Xt)



DESCRIPTION
     The XtAddEventHandler function registers a procedure with
     the dispatch mechanism that is to be called when an event
     that matches the mask occurs on the specified widget.  If
     the procedure is already registered with the same client-
     data, an OR operation combines the specified mask into the
     existing mask.  If the widget is realized, XtAddEventHandler
     calls XSelectInput, if necessary.

     The XtAddRawEventHandler function is similar to
     XtAddEventHandler except that it does not affect the
     widget's mask and never causes an XSelectInput for its
     events.  Note that the widget might already have those mask
     bits set because of other nonraw event handlers registered
     on it.

     The XtAddRawEventHandler function is similar to
     XtAddEventHandler except that it does not affect the
     widget's mask and never causes an XSelectInput for its
     events.  Note that the widget might already have those mask
     bits set because of other nonraw event handlers registered
     on it.

     The XtRemoveRawEventHandler function stops the specified
     procedure from receiving the specified events.  Because the
     procedure is a raw event handler, this does not affect the
     widget's mask and never causes a call on XSelectInput.

   Arguments
     These functions accept the following arguments:

     client-data
             Specifies additional data to be passed to the
             client's event handler.

     event-mask
             Specifies the event mask for which to call or unre-
             gister this procedure.

     nonmaskable
             Specifies a Boolean value that indicates whether
             this procedure should be called or removed on the
             nonmaskable events (GraphicsExpose, NoExpose,
             SelectionClear, SelectionRequest,
             SelectionNotify, ClientMessage, and
             MappingNotify).

     proc    Specifies the procedure that is to be added or re-
             moved.

     w       Specifies the widget for which this event handler is
             being registered.



2                                                  November, 1990

XtAddEventHandler(3Xt)                     XtAddEventHandler(3Xt)



SEE ALSO
     XtAppNextEvent(3Xt), XtBuildEventMask(3Xt)

     X Toolkit Intrinsics - C Language Interface

     Xlib - C Language Interface


















































November, 1990                                                  3