---
name: "MapWindow"
section: "2"
platform: "linux"
package: "perl-tk"
version: "b11.02-5"
release: "Debian 1.3 (Bo)"
platforms: ["linux"]
url: "https://new.carta.tech/MapWindow"
---

# MapWindow(2)

map or unmap a window

## NAME

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

## SYNOPSIS

```
#include <tk.h>

Tk_Window
Tk_MapWindow(tkwin)

Tk_UnmapWindow(tkwin)
```

## ARGUMENTS

Token for window.

## 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 doesn't already exist. See the **Tk\_CreateMainWindow** 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\_CreateChildWindow** was used to create it), then event handlers interested in map and unmap events are invoked immediately.  If *tkwin* isn't 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

map, unmap, window