Tk_ManageGeometry(3)

💖 Tk_ManageGeometry(3) 💖

okay bestie, welcome to the <pink>Tk_ManageGeometry(3)</pink> page from Tk Library Procedures — yes, the manual name is folded in right here at the top like a little name tag 🫶. This one is all about arranging to handle geometry requests for a window, and it’s lowkey giving “backstage pass to the geometry managers” energy. 💅

🌸 NAME 🌸

Tk_ManageGeometry — arrange to handle geometry requests for a window.

✨ SYNOPSIS ✨

#include <tk.h>

Tk_ManageGeometry(tkwin, mgrPtr, clientData)

🎀 ARGUMENTS 🎀

• Tk_Window tkwin (in) — token for the window to be managed. 👑
• const Tk_GeomMgr *mgrPtr (in) — pointer to the data structure containing information about the geometry manager, or NULL to indicate that tkwin’s geometry should not be managed anymore. 🛑 The data structure pointed to by mgrPtr must be static: Tk keeps a reference to it as long as the window is managed. no cap, this matters.
• void *clientData (in) — an arbitrary one-word value to pass to the geometry manager callbacks. 🎁

🦋 DESCRIPTION 🦋

Tk_ManageGeometry arranges for a particular geometry manager, described by the mgrPtr argument, to control the geometry of a particular content window, given by tkwin. If tkwin was previously managed by some other geometry manager, the previous manager loses control in favor of the new one. If mgrPtr is NULL, geometry management is cancelled for tkwin. periodt. ✨

The structure pointed to by mgrPtr contains information about the geometry manager:

typedef struct {
    const char *name;
    Tk_GeomRequestProc *requestProc;
    Tk_GeomLostContentProc *lostContentProc;
} Tk_GeomMgr;

The name field is the textual name for the geometry manager, such as pack or place; this value will be returned by the command winfo manager. iykyk. 🏷️

requestProc is a procedure in the geometry manager that will be invoked whenever Tk_GeometryRequest is called by the content window to change its desired geometry. requestProc should have arguments and results that match the type Tk_GeomRequestProc:

typedef void Tk_GeomRequestProc(
        void *clientData,
        Tk_Window tkwin);

The parameters to requestProc will be identical to the corresponding parameters passed to Tk_ManageGeometry. clientData usually points to a data structure containing application-specific information about how to manage tkwin’s geometry. 💖

The lostContentProc field of mgrPtr points to another procedure in the geometry manager. Tk will invoke lostContentProc if some other manager calls Tk_ManageGeometry to claim tkwin away from the current geometry manager. 🚨

bestie, listen: lostContentProc is not invoked if Tk_ManageGeometry is called with a NULL value for mgrPtr (presumably the current geometry manager has made this call, so it already knows that the window is no longer managed), nor is it called if mgrPtr is the same as the window’s current geometry manager. that’s the rule, not me being dramatic. 💀

lostContentProc should have arguments and results that match the following prototype:

typedef void Tk_GeomLostContentProc(
        void *clientData,
        Tk_Window tkwin);

The parameters to lostContentProc will be identical to the corresponding parameters passed to Tk_ManageGeometry. fr fr. 🫶

🔥 KEYWORDS 🔥

callback, geometry, managed, request, unmanaged — the whole keyword crew is here, accounted for. 🎀

---

cute sign-off: source Tk, version/date field 4.0 — okay bye bestie, go manage some geometry and slay 💖🦋✨