Writes a string of characters and their attributes to the screen.
Restriction: This routine is supported for native COBOL only.
Syntax:
call "CBL_WRITE_SCR_CHATTRS" using screen-position
character-buffer
attribute-buffer
string-length
returning status-code
Parameters
-
screen-position
- Group predefined as
cblt-screen-position containing:
01 cblt-screen-position typedef.
03 cblte-scrp-row cblt-x1-compx. *> pic x comp-x.
03 cblte-scrp-col cblt-x1-compx. *> pic x comp-x.
-
character-buffer
- Call prototype (see
Key): pic x (n).
- Picture: pic x (n).
-
attribute-buffer
- Call prototype (see
Key): pic x (n).
- Picture: pic x (n).
-
string-length
- Call prototype (see
Key): cblt-x2-compx.
- Picture: pic x (2) comp-x.
-
status-code
- See
Library Routines - Key.
On Entry:
|
screen-position
|
The screen position at which to start writing. The top left corner is row 0, column 0. See
Screen Routines
|
|
character-buffer
|
The characters to write.
|
|
attribute-buffer
|
The attribute(s) to write. Use the following table to set one or more attributes:
| B"10000000"
|
BACKGROUND HIGHLIGHT
|
| B"01000000"
|
BACKGROUND-COLOR (RED)
|
| B"00100000"
|
BACKGROUND-COLOR (GREEN)
|
| B"00010000"
|
BACKGROUND-COLOR (BLUE)
|
| B"00001000"
|
FOREGROUND HIGHLIGHT
|
| B"00000100"
|
FOREGROUND-COLOR (RED)
|
| B"00000010"
|
FOREGROUND-COLOR (GREEN)
|
| B"00000001"
|
FOREGROUND-COLOR (BLUE)
|
|
|
string-length
|
The length of the string to write. If this would go off the end of the screen, the write finishes at the end of the screen.
|
Comments:
The blink attribute is not supported on this COBOL system. Specifying that a character is to blink results in the character being displayed with a bright background color.