Tk\_HandleEvent(3) Tk Library Procedures Tk\_HandleEvent(3)

```

```

# [NAME](#NAME)

Tk\_HandleEvent - invoke event handlers for window system events

# [SYNOPSIS](#SYNOPSIS)

```
#include <tk.h>

Tk_HandleEvent(eventPtr)
```

# [ARGUMENTS](#ARGUMENTS)

XEvent *\*eventPtr* (in)

Pointer to X event to dispatch to relevant handler(s). It is important that all unused fields of the structure be set to zero.

```
    
```

# [DESCRIPTION](#DESCRIPTION)

**Tk\_HandleEvent** is a lower-level procedure that deals with window events. It is called by **Tcl\_ServiceEvent** (and indirectly by **Tcl\_DoOneEvent**), and in a few other cases within Tk. It makes callbacks to any window event handlers (created by calls to **Tk\_CreateEventHandler**) that match *eventPtr* and then returns. In some cases it may be useful for an application to bypass the Tk event queue and call **Tk\_HandleEvent** directly instead of calling **Tcl\_QueueEvent** followed by **Tcl\_ServiceEvent**.

This procedure may be invoked recursively. For example, it is possible to invoke **Tk\_HandleEvent** recursively from a handler called by **Tk\_HandleEvent**. 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.

# [KEYWORDS](#KEYWORDS)

callback, event, handler, window

Tk

---

Document: Tk_HandleEvent(3) from tk 9.1.0-r0 (Chainguard OS)
Source: https://downloads.sourceforge.net/sourceforge/tcl/tk9.1.0-src.tar.gz