XtAddEventHandler(3X11) COMMAND REFERENCE XtAddEventHandler(3X11)



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;
           caddr_t client_data;

     void XtAddRawEventHandler(w, event_mask, nonmaskable, proc,
     client_data)
           Widget w;
           EventMask event_mask;
           Boolean nonmaskable;
           XtEventHandler proc;
           caddr_t client_data;

     void XtRemoveEventHandler(w, event_mask, nonmaskable, proc,
     client_data)
           Widget w;
           EventMask event_mask;
           Boolean nonmaskable;
           XtEventHandler proc;
           caddr_t client_data;

     void XtRemoveRawEventHandler(w, event_mask, nonmaskable,
     proc, client_data)
           Widget w;
           EventMask event_mask;
           Boolean nonmaskable;
           XtEventHandler proc;
           caddr_t client_data;

     This is user-contributed.

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
               unregister this procedure.

     nonmaskable
               Specifies a Boolean value that indicates whether
               this procedure should be called or removed on the



X Version 11            1 September 1988                        1

XtAddEventHandler(3X11) COMMAND REFERENCE XtAddEventHandler(3X11)



               nonmaskable events (GraphicsExpose, NoExpose,
               SelectionClear, SelectionRequest, SelectionNotify,
               ClientMessage, and MappingNotify).

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

     w         Specifies the widget for which this event handler
               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
     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.

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













X Version 11            1 September 1988                        2

%%index%%
na:624,180;
sy:804,3420;
de:4224,1762;
se:5986,413;
%%index%%000000000085