Skip to content

Latest commit

 

History

History
46 lines (30 loc) · 1.13 KB

CloseScreen.md

File metadata and controls

46 lines (30 loc) · 1.13 KB
Raw

NAME

CloseScreen -- Close an Intuition screen.

SYNOPSIS

    [Success =] CloseScreen( Screen )
    [D0]                     A0

    [BOOL] CloseScreen( struct Screen * );
    /* returns BOOL in V36 and greater */

Links: Screen Screen

FUNCTION

Unlinks the screen, unlinks the viewport, deallocates everything that Intuition allocated when the screen was opened (using OpenScreen). Doesn't care whether or not there are still any windows attached to the screen. Doesn't try to close any attached windows; in fact, ignores them altogether (but see below for changes in V36).

If this is the last screen to go, attempts to reopen Workbench.

New for V36: this function will refuse to close the screen if there are windows open on the screen when CloseScreen() is called. This avoids the almost certain crash when a screen is closed out from under a window.

INPUTS

Screen = pointer to the screen to be closed.

RESULT New for V36: returns TRUE (1) if screen is closed, returns FALSE (0) if screen had open windows when called.

BUGS

SEE ALSO

OpenScreen