Click above to get retro games delivered to your door ever month!

CLEARWIN()

Syntax:     CLEARWIN([<expN1>][,<expN2>]
                   [,<expN3>][,<expN4>][,<attr>][,<char>])

Arguments:  <expN1> denotes the starting line to erase from (default:
            cursor line).
            <expN2> denotes the first column to erase from (default:
            cursor column).
            <expN3> determines the last line to be erased (default: last
            screen or window line).
            <expN4> denotes the last column to be erased (default:
            right-hand screen or window edge).
            <attr> denotes the attribute to be used in the erasure
            (default: standard attribute CLEARA).
            <char> the symbol used for the erasure (default: standard
            symbol CLEARB).

Returns:    A character string.
            A null string is returned.

Usage:      CLEARWIN() is intended to erase a defined screen area.
            This area extends from the line <expN1> to the line
            <expN3> and from the column <expN2> to the column
            <expN4>.  Lines and columns from the actual cursor position
            for <expN1> and <expN2> ,and the last line and column of
            the window for <expN3> and <expN4> will be automatically
            used without this argument.

            Standard attribute and symbol (CLEARA and CLEARB), or
            the attribute <attr> and the symbol <char>, will be used for
            the erasure.

            The attribute <attr> and the symbol <char> character can be
            indicated in different ways.  Refer also to the introduction to
            this section.  The standard attribute and symbol can be set
            with SETCLEARA() and SETCLEARB().

Notes:      The function will default to the actual cursor position if no
            arguments are indicated for the lines or columns.

Library:    CT1.LIB


--------------------------------- Example ------------------------------

Examples:   * Erase with attribute CLEARA and the character
            * CLEARB.  Erase from the actual cursor position
            * to the end of the screen area.
            CLEARWIN()

            * Ditto from the actual column position
            * in the line 23.
            CLEARWIN(23)

            * Erase the window between line 23, column 15
            * and line 24, column 70.
            CLEARWIN(23,15,24,70)

            * Attribute indicated differently; use the
            * erasure symbol set for CLEARB.
            CLEARWIN(23,15,24,70,4)             && Red on black
            CLEARWIN(23,15,24,70,"4/1")         && Red on white
            CLEARWIN(23,15,24,70,"B/W")         && Blue on white

            * Erase when attribute and symbol are
            * specified.
            CLEARWIN(23,15,24,70,"B/W","+")     && Blue on white