# Copyright (c) 1990-1992 The Regents of the University of California.
# Copyright (c) 1994-1996 Sun Microsystems, Inc.
# See the file "license.terms" for information on usage and redistribution
# of this file, and for a DISCLAIMER OF ALL WARRANTIES.
#
#
=head1 NAME
Tk_HandleEvent - invoke event handlers for window system events
=for category C Programming
=head1 SYNOPSIS
Btk.hE>
B(I)
=head1 ARGUMENTS
=over 4
=item XEvent *eventPtr (in)
Pointer to X event to dispatch to relevant handler(s).
=back
=head1 DESCRIPTION
B is a lower-level procedure that deals with window
events. It is called by B (and indirectly by
B), and in a few other cases within Tk.
It makes callbacks to any window event
handlers (created by calls to B)
that match I and then returns. In some cases
it may be useful for an application to bypass the Tk event
queue and call B directly instead of
calling B followed by
B.
This procedure may be invoked recursively. For example,
it is possible to invoke B recursively
from a handler called by B. This sort
of operation is useful in some modal situations, such
as when a
notifier has been popped up and an application wishes to
wait for the user to click a button in the notifier before
doing anything else.
=head1 KEYWORDS
callback, event, handler, window