Tk_MapWindow - Man Page

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

Referenced By

The man page Tk_UnmapWindow(3) is an alias of Tk_MapWindow(3).

Tk Library Procedures