SCREEN INSERT_CHARS

SCREEN INSERT_CHARS inserts the specified characters at the specified row and column.  Characters to the right of the insertion are shifted to the right.  Any characters which do not fit on the cursor line are discarded.  The cursor is positioned following the last inserted character.

SYNTAX

SCREEN INSERT_CHARS /USING/ window_id string start_row start_column rendition

window_id

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

string

is a string expression that specifies the characters to be inserted.

start_row

is an integer expression that specifies the row position at which to begin the insertion.

start_column

is an integer expression that specifies the column position at which to begin the insertion.

rendition

specifies the video attributes of the inserted characters.  More than one attribute may be defined by separating the attributes with plus signs.

    

The valid video attributes are:

  • NORMAL specifies normal video attribute.  [default setting]
  • BLINK specifies blinking video attribute.
  • BOLD specifies bold face video attribute.
  • REVERSE specifies reverse video attribute.
  • UNDERLINE specifies underlining video attribute.

EXAMPLE

SCREEN INSERT_CHARS MAIN_ID, &
     
'CONTINUE WRITE-RECORD QUIT' 16 10 NORMAL

This example displays a short menu at row 16, column 10 of the window.

Back to Statements and Commands    Next page SCREEN INSERT_LINE