UNMAP

  Performs either of two functions depending on the variant used.

  One variant disassociates a window from its buffer and removes the window
  from the screen.

  The other variant makes the specified widget invisible.

  Syntax

     UNMAP (window)

            or

     UNMAP (widget)

  Parameters

     window     The window you want to unmap.

     widget     The widget instance you want to make invisible.

  Comments

     When you are using the first variant, which unmaps a window, the
     unmapped window is not deleted from the list of available windows.  To
     make the window appear on the screen again, use MAP.  The screen area
     of the unmapped window is either erased or returned to any windows
     occluded by the unmapped window.

     If you unmap the current window, DECTPU tries to move the cursor
     position to the window that was most recently the current window.  The
     window in which DECTPU puts the cursor becomes the new current window
     and the buffer associated with this window becomes the new current
     buffer.

     The UNMAP (widget) variant calls the Xlib routine MAP WINDOW to unmap
     the widget's DECwindows window from the screen.  If the unmapped
     DECwindows window is DECTPU's top-level DECwindows window, DECTPU
     automatically maps the top-level window again if a READ_CHAR, READ_KEY,
     or READ_LINE statement is encountered during execution.

  Examples

     UNMAP (CURRENT_WINDOW);

     Removes the current window from the screen and disassociates the buffer
     that was mapped to it.

     UNMAP (example_widget);

     Causes the widget instance assigned to the variable "example_widget" to
     become invisible.

  Related topics

     CREATE_WIDGET   CURRENT_BUFFER   CURRENT_WINDOW   DELETE
     MAP             MANAGE_WIDGET    REALIZE_WIDGET
     SET(MAPPED_WHEN_MANAGED)         UNMANAGE_WIDGET