The Screen object encapsulates the host presentation space. The presentation space is a virtual screen which contains all the characters and attributes that would be seen on a traditional emulator screen. This virtual screen is the primary object for text-based interactions with the host. The Screen object provides methods that manipulate text, search the screen, send keystrokes to the host, and work with the cursor.
A Screen object can be obtained from the Screen property of an instance of the Session object.
The raw presentation space data is maintained in a series of planes which can be accessed by various methods within this class. The text plane contains the actual characters in the presentation space. Most of the methods in the Screen class work exclusively with the text plane.
The remaining planes contain the corresponding attributes for each character in the text plane. The color plane contains color characteristics. The field plane contains the field attributes. The extended plane contains the extended field attributes. The color, field, and extended planes are not interpreted by any of the methods in this class.
The cursor is an offset into the virtual
screen buffer and ranges from 0 to the last character of the screen buffer.
For a 3270 model 2 screen, the last screen position is 1919 (80 x 24 -
1). Cursor position 0 corresponds to row 1 column 1 of the screen. Cursor
position 1919 corresponds to row 24 column 80 of the screen.