SCREEN DRAW_RECTANGLE

SCREEN DRAW_RECTANGLE draws a rectangle in a window, given the position of the upper left corner and lower right corner.  The characters used to draw the lines making up the rectangle depend on the type of terminal.  The cursor position does not change.

SYNTAX

SCREEN DRAW_RECTANGLE /USING/ window_id top_left_row top_left_column bottom_right_row
     
bottom_right_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.

top_left_row

is an integer expression that specifies the row number of the top left corner of the rectangle.

top_left_column

is an integer expression that specifies the column number of the top left corner of the rectangle.

bottom_right_row

is an integer expression that specifies the row number of the bottom right corner of the rectangle.

bottom_right_column

is an integer expression that specifies the column number of the bottom right corner of the rectangle.

rendition

specifies the video attributes of the drawn rectangle.  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 DRAW_RECTANGLE USING MAIN_ID 5 10 15 40 NORMAL

This example demonstrates how a rectangle is used to highlight an important portion of the window.  A rectangle is drawn with the top left corner at the 5th row and 10th column and the bottom right corner at the 15th row and the 40th column position.  The video rendition is normal.

Bact to Statements and Commands    Next page SCREEN END_UPDATE