SCREEN ERASE_WINDOW

SCREEN ERASE_WINDOW causes all or part of a window to be erased by replacing each character with a blank.  The cursor is positioned at the first free position after the erased portion.  If the entire window is erased, the cursor is positioned at row 1 and column 1.

SYNTAX

SCREEN ERASE_WINDOW /USING/ window_id start_row start_column end_row end_column

window_id

is an integer system field, Global Storage (GS) field, or user-defined field that contains the window ID assigned to the window.

start_row

is an integer expression that specifies the row at which the erase operation begins.  If zero, starting row and starting column are both ignored, and the entire window is erased.

start_column

is an integer expression that specifies the column at which the erase operation begins.  If zero, starting column and starting row are both ignored, and the entire window is erased.

end_row

is an integer expression that specifies the row at which the erase operation ends, that is, the last row to be erased.  If zero, the ending row and ending column are both ignored, and all the remaining rows of the window are erased.

end_column

is an integer expression that specifies the column at which the erase operation ends, that is, the last column to be erased.  If zero, the ending column and ending row are both ignored and all the remaining rows of the window are erased.

EXAMPLE

SCREEN ERASE WINDOW USING MAIN_ID 1 1 20 78

This example erases the total window contents contained within the area from row 1, column 1 to row 20, column 78.

Back to Statements and Commands    Next page SCREEN FLUSH_BUFFER