Return a string containing a rectangular area of the screen that includes blanks and box drawing characters.
String HostScreen.getRectangle(int row, int column, int width, int height); String HostScreen.getRectangle(int offset, int width, int height); |
Arguments
HostScreen
Required. HostScreen object.
Offset
Required when not a row/column set of parameters. The offset position on the host screen (starts with 0).
row
Required when not a single offset. The row number on the host screen (starts with 1)
column
Required when not a single offset. The column number on the host screen (starts with 1).
width
Required. The width / number of columns
height
Required. The height / number of rows in the rectangle.
Remarks
This method is like a concatenation of multiple GetTextFull calls, with all blanks included. There are no Carriage returns indicating end of a "row" so after calling this, treat each "width" chop into the string as a row.
Another key difference from GetTextFull is that any box-drawing characters for an ASCII terminal type will be translated to corresponding Unicode graphic characters. With GetTextFull these characters will be an odd assortment of simple letters. So, if you wish to have your screen read accurately render box-drawing characters, use getRectangle.
Requirements
Inventu Viewer+
Applies To: HostScreen object
© 2022 Inventu Corporation
