Swaps a string of characters and their attributes with a string from the screen.
Restriction: This routine is supported for native COBOL only.
Syntax:
call "CBL_SWAP_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 attributes 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.
|
On Exit:
|
character-buffer
|
The characters read from the screen. This data item must be at least as long as specified by
string-length; positions in it beyond that length are unchanged.
|
|
attribute-buffer
|
The attributes read from the screen. This data item must be at least as long as specified by
string-length; positions in it beyond that length are unchanged.
|
|
string-length
|
If the end of the screen is reached the length swapped (in cells, that is, character-attribute pairs) is returned in here.
|