Tk\_ManageGeometry(3) Tk Library Procedures Tk\_ManageGeometry(3)

```

```

# [NAME](#NAME)

Tk\_ManageGeometry - arrange to handle geometry requests for a window

# [SYNOPSIS](#SYNOPSIS)

```
#include <tk.h>

Tk_ManageGeometry(tkwin, mgrPtr, clientData)
```

# [ARGUMENTS](#ARGUMENTS)

Tk\_Window *tkwin* (in)

Token for window to be managed.

const Tk\_GeomMgr *\*mgrPtr* (in)

Pointer to 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.

void *\*clientData* (in)

Arbitrary one-word value to pass to geometry manager callbacks.

```
    
```

# [DESCRIPTION](#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*.

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**.

*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. *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. *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**.

# [KEYWORDS](#KEYWORDS)

callback, geometry, managed, request, unmanaged

4.0 Tk

---

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