Reference Type: Supported, Category: XGF Function Library, Integration Agreement: 3173
This API clears a rectangular region of the screen. It is useful to
clear a portion of the screen.
The CLEAR function works by printing spaces using the current screen attribute in the specified region. If the screen attribute is changed and then the CLEAR function is used, the rectangular region is cleared in the new attribute.
A call to the PREP^XGF(): Screen/Keyboard Setup API must be made at some point prior to calling CLEAR^XGF.
Acceptable values for the top and bottom parameters range from 0 to IOSL-1. Acceptable values for the left and right parameters range from 0 to IOM-1.
(required) Top screen coordinate for box.
(required) Left screen coordinate for box.
(required) Bottom screen coordinate for box.
(required) Right screen coordinate for box.
|$x and $y:||
Set to the right and bottom specified as parameters.
NOTE: See also: RESTORE^XGF(): Screen Restore, SAVE^XGF(): Screen Save, and WIN^XGF(): Screen Text Window APIs.
For example, to clear the entire screen, do the following:
To clear a rectangular region in the center of the screen, do the following:
August 26, 2011