SCREEN ERASE_CHARS

SCREEN ERASE_CHARS erases characters in a window by replacing them with blanks.  The remaining text in the window is not moved.  An erase operation is limited to the specified line.  If the number of characters is greater than the number of characters remaining in the line, all characters from the starting position to the end of the line are erased.  The cursor is positioned at the first erased character.

SYNTAX

SCREEN ERASE_CHARS /USING/ window_id number of characters start_row start_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.

number of characters

is an integer expression that specifies the number of characters to be erased.

start_row

is an integer expression that specifies the row in which the erase operation begins.

start_column

is an integer expression that specifies the column in which the erase operation begins.

EXAMPLE

SCREEN ERASE_CHARS USING MAIN_ID 10 1 1

This example demonstrates how SCREEN ERASE_CHARS is used to clear a portion of the window that is no longer necessary.  The first ten characters in row 1 are blanked.

Back to Statements and Commands    Next page SCREEN ERASE_LINE