Tk_OwnSelection(3tk)

💖 Tk_OwnSelection — bestie, you're the owner now 💅

okay so this is Tk_OwnSelection(3tk) from the Tk Library Procedures, and it's literally about handing your window the aux cord for the primary selection. let's get into it 🎀

---

✨ NAME ✨

Tk_OwnSelection — make a window the owner of the primary selection 👑

---

🌸 SYNOPSIS 🌸

#include <tk.h>

Tk_OwnSelection(tkwin, selection, proc, clientData)

---

🦋 ARGUMENTS 🦋

• Tk_Window tkwin (in) — the window that's about to become the shiny new selection owner. main character behavior, honestly.
• Atom selection (in) — the name of the selection you're claiming, like XA_PRIMARY for example.
• Tk_LostSelProc *proc (in) — the procedure that gets invoked later when tkwin loses selection ownership. think of it as the "you're not the owner anymore" callback 😭
• void *clientData (in) — an arbitrary one-word value that gets passed along to proc. no questions asked, just vibes.

---

💜 DESCRIPTION 💜

So Tk_OwnSelection arranges for tkwin to become the new owner of the selection specified by the atom selection. Once this call finishes, future requests for that selection get directed to the handlers created for tkwin using Tk_CreateSelHandler. periodt.

And then, when tkwin eventually loses the selection ownership — yeah, it happens to everyone — proc will be invoked so the window can clean itself up (like, e.g. by unhighlighting the selection). so thoughtful of it 🫶

proc should have arguments and a result that match the type Tk_LostSelProc:

typedef void Tk_LostSelProc(
        void *clientData);

The clientData parameter to proc is a copy of the clientData argument that was given to Tk_OwnSelection, and it's usually a pointer to a data structure containing application-specific information about tkwin. iykyk 💫

---

🔥 KEYWORDS 🔥

own, selection owner

---

ngl bestie, if you skip the proc you're gonna be that window that never cleans up after itself, and nobody wants that energy 💀

slay, go own that selection ✨🌈💖

— with love, from the Tk Library Procedures, version 4.0, dated Tk_OwnSelection(3tk), which is giving vintage but still iconic 🎀💅