---
name: "MapWindow"
section: "3"
platform: "macos"
package: "tcl"
version: "152"
release: "macOS 26.5"
platforms: ["macos"]
url: "https://new.carta.tech/MapWindow/3"
---

# 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

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