Tk\_MapWindow(3) Tk Library Procedures Tk\_MapWindow(3)

```

```

# [NAME](#NAME)

Tk\_MapWindow, Tk\_UnmapWindow - map or unmap a window

# [SYNOPSIS](#SYNOPSIS)

```
#include <tk.h>

Tk_Window
Tk_MapWindow(tkwin)

Tk_UnmapWindow(tkwin)
```

# [ARGUMENTS](#ARGUMENTS)

Tk\_Window *tkwin* (in)

Token for window.

```
    
```

# [DESCRIPTION](#DESCRIPTION)

These procedures may be used to map and unmap windows managed by Tk. **Tk\_MapWindow** maps the window given by *tkwin*, and also creates an X window corresponding to *tkwin* if it does not already exist. See the **Tk\_CreateWindow** manual entry for information on deferred window creation. **Tk\_UnmapWindow** unmaps *tkwin*'s window from the screen.

If *tkwin* is a child window (i.e. **Tk\_CreateWindow** was used to create a child window), then event handlers interested in map and unmap events are invoked immediately. If *tkwin* is not an internal window, then the event handlers will be invoked later, after X has seen the request and returned an event for it.

These procedures should be used in place of the X procedures **XMapWindow** and **XUnmapWindow**, since they update Tk's local data structure for *tkwin*. Applications using Tk should not invoke **XMapWindow** and **XUnmapWindow** directly.

# [KEYWORDS](#KEYWORDS)

map, unmap, window

Tk

---

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