summaryrefslogtreecommitdiffstats
path: root/doc/HandleEvent.3
diff options
context:
space:
mode:
authordkf <donal.k.fellows@manchester.ac.uk>2010-01-02 10:43:25 (GMT)
committerdkf <donal.k.fellows@manchester.ac.uk>2010-01-02 10:43:25 (GMT)
commita8f810f189c1948ce32cf32178f71013a85762c2 (patch)
tree53a45c4d70540a15b2d1bb2508e567ad721e65b6 /doc/HandleEvent.3
parent1e85ca777ce26da8f7247f965272c9b9f670049c (diff)
downloadtk-a8f810f189c1948ce32cf32178f71013a85762c2.zip
tk-a8f810f189c1948ce32cf32178f71013a85762c2.tar.gz
tk-a8f810f189c1948ce32cf32178f71013a85762c2.tar.bz2
Fix [Bug 1373712] and [Bug 1924761].
Diffstat (limited to 'doc/HandleEvent.3')
-rw-r--r--doc/HandleEvent.37
1 files changed, 4 insertions, 3 deletions
diff --git a/doc/HandleEvent.3 b/doc/HandleEvent.3
index ea461d5..6067e6e 100644
--- a/doc/HandleEvent.3
+++ b/doc/HandleEvent.3
@@ -5,7 +5,7 @@
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
-'\" RCS: @(#) $Id: HandleEvent.3,v 1.4 1999/04/21 21:53:22 rjohnson Exp $
+'\" RCS: @(#) $Id: HandleEvent.3,v 1.4.28.1 2010/01/02 10:43:26 dkf Exp $
'\"
.so man.macros
.TH Tk_HandleEvent 3 "" Tk "Tk Library Procedures"
@@ -20,14 +20,15 @@ Tk_HandleEvent \- invoke event handlers for window system events
.SH ARGUMENTS
.AS XEvent *eventPtr
.AP XEvent *eventPtr in
-Pointer to X event to dispatch to relevant handler(s).
+Pointer to X event to dispatch to relevant handler(s). It is important
+that all unused fields of the structure be set to zero.
.BE
.SH DESCRIPTION
.PP
\fBTk_HandleEvent\fR is a lower-level procedure that deals with window
events. It is called by \fBTcl_ServiceEvent\fR (and indirectly by
-\fBTk_DoOneEvent\fR), and in a few other cases within Tk.
+\fBTcl_DoOneEvent\fR), and in a few other cases within Tk.
It makes callbacks to any window event
handlers (created by calls to \fBTk_CreateEventHandler\fR)
that match \fIeventPtr\fR and then returns. In some cases