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, VAXTPU tries to move the cursor
    position to the window that was most recently the current window.  The
    window in which VAXTPU 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 VAXTPU's top-level DECwindows window, VAXTPU
    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