Tk_Grab(3)

okay bestie, welcome to the Tk Library Procedures page for Tk_Grab(3) — aka the grab-state control manual, and yes it’s giving main character window energy 💅✨

🎀 NAME 🎀

Tk_Grab, Tk_Ungrab — manipulate grab state in an application

---

✨ SYNOPSIS ✨

C signatures, verbatim, no edits, periodt 🫶

#include <tk.h>

int
Tk_Grab(interp, tkwin, grabGlobal)

Tk_Ungrab(tkwin)

---

💖 ARGUMENTS 💖

• Tcl_Interp *interp (in) — the interpreter used for error reporting.
• Tk_Window tkwin (in) — the window on whose behalf the pointer is to be grabbed or released.
• int grabGlobal (in) — a Boolean indicating whether the grab is global or application local.

---

🦋 DESCRIPTION 🦋

These functions are how you set or release a global or application-local grab. When a grab is set on a particular window in a Tk application, mouse and keyboard events can only be received by that window and its descendants. Mouse and keyboard events for windows outside the tree rooted at tkwin get redirected to tkwin.

If the grab is global, then all mouse and keyboard events for windows outside the tree rooted at tkwin — even those intended for windows in other applications — will be redirected to tkwin.

If the grab is application local, only mouse and keyboard events intended for windows within the same application (but outside the tree rooted at tkwin) will be redirected.

Tk_Grab sets a grab on a particular window. tkwin specifies the window on whose behalf the pointer is to be grabbed — the page calls it Tkwin right there, capital-T moment, same window ✨. grabGlobal indicates whether the grab should be global or application local; if it is non-zero, it means the grab should be global.

Normally, Tk_Grab returns TCL_OK. If an error occurs and the grab cannot be set, TCL_ERROR is returned and an error message is left in interp's result — the source literally says “left if interp's result”, which is giving typo energy 😭, but the meaning is error reporting via interp, no cap.

Once this call completes successfully, no window outside the tree rooted at tkwin will receive pointer- or keyboard-related events until the next call to Tk_Ungrab. If a previous grab was in effect within the application, then it is replaced with a new one.

👑 Big grab energy: outside-tree windows are on mute until Tk_Ungrab shows up.

Tk_Ungrab releases a grab on the mouse pointer and keyboard, if there is one set on the window given by tkwin. Once a grab is released, pointer and keyboard events will start being delivered to other windows again.

---

🌸 KEYWORDS 🌸

grab, window — that’s the whole keyword set, periodt 💅

---

💖 source/version: Tk · page: Tk_Grab(3) · date: not listed on this page, so no invented date, bestie 🎀