XtAddEventHandler(3Xt)     XT FUNCTIONS    XtAddEventHandler(3Xt)


NAME
       XtAddEventHandler, XtAddRawEventHandler, XtRemoveEven-
       tHandler, XtRemoveRawEventHandler - add and remove event
       handlers

SYNTAX
       void XtAddEventHandler(w, eventmask, nonmaskable, proc,
       clientdata)
             Widget w;
             EventMask eventmask;
             Boolean nonmaskable;
             XtEventHandler proc;
             XtPointer clientdata;

       void XtAddRawEventHandler(w, eventmask, nonmaskable,
       proc, clientdata)
             Widget w;
             EventMask eventmask;
             Boolean nonmaskable;
             XtEventHandler proc;
             XtPointer clientdata;

       void XtRemoveEventHandler(w, eventmask, nonmaskable,
       proc, clientdata)
             Widget w;
             EventMask eventmask;
             Boolean nonmaskable;
             XtEventHandler proc;
             XtPointer clientdata;

       void XtRemoveRawEventHandler(w, eventmask, nonmaskable,
       proc, clientdata)
             Widget w;
             EventMask eventmask;
             Boolean nonmaskable;
             XtEventHandler proc;
             XtPointer clientdata;

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

       eventmask
                 Specifies the event mask for which to call or
                 unregister 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).



X Version 11                Release 3                           1

XtAddEventHandler(3Xt)     XT FUNCTIONS    XtAddEventHandler(3Xt)


       proc      Specifies the procedure that is to be added or
                 removed.

       w         Specifies the widget for which this event han-
                 dler is being registered.

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, the specified mask is ORed into the existing
       mask.  If the widget is realized, XtAddEventHandler calls
       XSelectInput, if necessary.

       The XtAddRawEventHandler function is similar to XtAddEven-
       tHandler 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 XtAddEven-
       tHandler 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.

SEE ALSO
       XtAppNextEvent(3Xt), XtBuildEventMask(3Xt)
       X Toolkit Intrinsics - C Language Interface
       Xlib - C Language X Interface





















X Version 11                Release 3                           2