---
name: "Tk_MapWindow"
section: "3"
platform: "linux"
package: "tk"
version: "8.6.16-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/Tk_MapWindow"
---

# Tk\_MapWindow(3)

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

- Tk\_Window *tkwin* (in)

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

map, unmap, window