CBL_READ_SCR_ATTRS
Reads a string of attributes from the screen.
Syntax:
call "CBL_READ_SCR_ATTRS" using screen-position
attribute-buffer
string-length
returning status-code
Parameters:
|
Using call prototype (see Library Routines - Key) |
Picture (32-bit systems) |
screen-position |
Group predefined as cblt-screen-position containing: |
Group containing: |
|
cblte-scrp-row |
|
cblt-x1-compx. |
|
pic x comp-x. |
|
cblte-scrp-col |
|
cblt-x1-compx. |
|
pic x comp-x. |
attribute-buffer |
pic x(n). |
pic x(n). |
string-length |
cblt-x2-compx. |
pic x(2) comp-x. |
status-code |
See Library Routines - Key. |
On Entry:
screen-position |
The screen position to start reading at. The top left corner is row 0, column
0. See Screen Routines. |
string-length |
The length of the string to read. |
On Exit:
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 read is returned in here. |
See Also: