HP 3000 Manuals

CLOSE FORM [ HP Business BASIC/XL Reference Manual ] MPE/iX 5.0 Documentation


HP Business BASIC/XL Reference Manual

CLOSE FORM 

CLOSE FORM closes the currently active form.  This statement is used with
both JOINFORM and VPLUS.

When an VPLUS form is active, the form file is also closed.  CLOSE FORM
does not close JOINFORM files.  When execution of the CLOSE FORM
statement is complete, the cursor is at the top of display memory and
memory lock, format lock, and block mode are off.

When CLEARALL, CLEARREST, or REMAIN are not specified, the form is closed
by deleting the individual lines of the form.  The contents of display
memory above and below the form are not deleted.  When the form is
deleted, the contents of display memory that follows the form are
scrolled into the area of display memory that previously contained the
form.

Syntax 

           [{;}         ]
           [{,} CLEARALL]
CLOSE FORM [CLEARREST   ]
           [REMAIN      ]

Parameters 

CLEARALL         Specifies that the form should be deleted from the
                 screen by placing the cursor at the home position and
                 clearing all of display memory.

CLEARREST        Specifies that the form should be deleted from the
                 screen by placing the cursor at the first line of the
                 form, and clearing display memory from that position to
                 the end.  The area of display memory above the form is
                 not affected.

REMAIN           Specifies that the form should be left on the screen.
                 It is unprotected after it is closed.

Examples 

The following statements show the use of the CLOSE FORM statement.

     200 CLOSE FORM             !FORM is cleared from the screen
     210 CLOSE FORM ;REMAIN     !FORM is left on the screen
     220 CLOSE FORM ,REMAIN     !FORM is left on the screen
     230 CLOSE FORM             !FORM is cleared from the screen
     240 CLOSE FORM ;CLEARREST  !Display memory is cleared from the
     245                        !first line of the form to the end
     250 CLOSE FORM :CLEARALL   !All of display memory is cleared

If REMAIN is entered preceded by a "," HP Business BASIC/XL will replace
it with a ";".



MPE/iX 5.0 Documentation