Topic       : The GFA-Basic Compendium
Author      : GFA Systemtechnik GmbH
Version     : GFABasic.HYP v2.98 (12/31/2023)
Subject     : Documentation/Programming
Nodes       : 899
Index Size  : 28056
HCP-Version : 3
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Document not found
@help       : Help
@options    : +g -i -s +z
@width      : 75
@hostname   : STRNGSRV
@hostname   : CAB     
@hostname   : HIGHWIRE
@hostname   : THING   
View Ref-FileCLEARW [#]n
TITLEW #n,title$
INFOW #n,info$
TOPW #n
FULLW [#]n

n: aexp
title$, info$: sexp

CLEARW deletes the contents of window number 'n'.

TITLEW writes the text in 'title$' in the top line of the window.

INFOW writes the text 'info$' on the second (information) line of the window.

TOPW activates the window number 'n'.

FULLW brings window 'n' to full screen size.

CLEARW clears every visible part of a window, without activating it.
Internally it is done by WIND_UPDATE() and WIND_GET().

Example:

    DEFFILL 1,2,4
    PBOX 0,0,639,399
    OPENW 1
    PAUSE 50
    FULLW #1
    PRINT " Window 1 "
    OPENW 4,100,100
    PAUSE 50
    CLEARW 1
    OPENW 3
    PAUSE 50
    TOPW #1
    PAUSE 50
    CLOSEW #1
    TITLEW 4," Window 4 "
    INFOW 3," Window 3 "
    PAUSE 100
    CLOSEW #3
    CLOSEW 4

--> Some windows are opened, altered and then closed again.

Memo: TITLEW and INFOW internally clip the string off at 78 characters.

      The compiler contains a bug such that CLEARW x and CLEARW #x call
      the same library routine. The library contains two routines:
      CLEARW x  - tops the window then clears it (never used)
      CLEARW #x - walks the rectangle list (all calls end up here)

      FULLW x and FULLW #x call different routines in the library:
      FULLW x  - not sure exactly what this one does yet
      FULLW #x - seems more straight forward

      If you don't use any of the GFA window commands the buffers for the
      TITLEW and INFOW strings are not even linked, so no memory is wasted.

      None of these commands properly check the window number.
      This is true for the editor and the library.

wind_set()+