HandleEvent.3
上传用户:rrhhcc
上传日期:2015-12-11
资源大小:54129k
文件大小:2k
- '"
- '" 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.
- '"
- '" RCS: @(#) $Id: HandleEvent.3,v 1.4 1999/04/21 21:53:22 rjohnson Exp $
- '"
- .so man.macros
- .TH Tk_HandleEvent 3 "" Tk "Tk Library Procedures"
- .BS
- .SH NAME
- Tk_HandleEvent - invoke event handlers for window system events
- .SH SYNOPSIS
- .nf
- fB#include <tk.h>fR
- .sp
- fBTk_HandleEventfR(fIeventPtrfR)
- .SH ARGUMENTS
- .AS XEvent *eventPtr
- .AP XEvent *eventPtr in
- Pointer to X event to dispatch to relevant handler(s).
- .BE
- .SH DESCRIPTION
- .PP
- fBTk_HandleEventfR is a lower-level procedure that deals with window
- events. It is called by fBTcl_ServiceEventfR (and indirectly by
- fBTk_DoOneEventfR), and in a few other cases within Tk.
- It makes callbacks to any window event
- handlers (created by calls to fBTk_CreateEventHandlerfR)
- that match fIeventPtrfR and then returns. In some cases
- it may be useful for an application to bypass the Tk event
- queue and call fBTk_HandleEventfR directly instead of
- calling fBTcl_QueueEventfR followed by
- fBTcl_ServiceEventfR.
- .PP
- This procedure may be invoked recursively. For example,
- it is possible to invoke fBTk_HandleEventfR recursively
- from a handler called by fBTk_HandleEventfR. 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.
- .SH KEYWORDS
- callback, event, handler, window