SCREEN PUT_WIDE_CHARS

SCREEN PUT_WIDE_CHARS writes double-wide characters to a specified location in the window.

SYNTAX

SCREEN PUT_WIDE_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 character string to be written.

start_row

is an integer expression that specifies the line at which output begins.  If zero, output begins on the current line.

start_column

is an integer value that specifies the column at which output begins.  If zero, output begins on the current column.

rendition

specifies the video attributes of the written 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 PUT_WIDE_CHARS USING MAIN_ID 'Western Region' &
     5 39 NORMAL

This example puts "Western Region" at row 5 and columns 39-67 of the window.  The size of each character is double wide.

NOTES:  Each double-wide character occupies 2 normal character positions.  An additional character space is automatically used at the beginning of the string that is specified.  Therefore, to determine the ending position of a string, count the number of characters in the string, multiply by two, and add one.

Back to Statements and Commands    Next page SCREEN PUT_WITH_SCROLL