Reads a string of characters and their attributes from the screen.
call "CBL_READ_SCR_CHATTRS" using screen-position character-buffer attribute-buffer string-length returning status-code
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. | |||
character-buffer | pic x(n). | pic x(n). | |||
attribute-buffer | pic x(n). | pic x(n). | |||
string-length | cblt-x2-compx. | pic x(2) comp-x. | |||
status-code | See Library Routines - Key. |
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. |
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 read (in cells, that is, character-attribute pairs) is returned in here. |