InfoConnect API Guide
Attachmate.Reflection.Emulation.IbmHosts Namespace / IIbmScreen Interface
Properties Methods Events

In This Topic
    IIbmScreen Interface Members
    In This Topic

    The following tables list the members exposed by IIbmScreen.

    Public Properties
     NameDescription
     PropertyGets or sets a value indicating whether the terminal automatically copies selected text to the Clipboard.  
     PropertyGets or sets the number of consecutive blank spaces between columns of data that are required for the data to be tab delimited.  
     PropertyGets or sets a value indicating whether text remains selected after it is copied to the Clipboard.  
     PropertyGets the number of columns in the screen.  
     PropertyGets or sets a value specifying whether the data copied from InfoConnect should be separated by delimiters at field boundaries or at word boundaries. This option controls formatting for spreadsheet or other cell-based information and affects only the text and BIFF formats.  
     PropertyGets or sets a value indicating whether to copy from InfoConnect to the BIFF (Binary Interchange File Format) Clipboard format  
     PropertyGets or sets a value indicating whether to copy from InfoConnect to the DIB (Device Independent Bitmap) Clipboard format  
     PropertyGets or sets a value indicating whether to copy from InfoConnect to the InfoConnect proprietary Clipboard format  
     PropertyGets or sets a value indicating whether to retain host colors when copying to the RTF (Rich Text Format) Clipboard format  
     PropertyGets or sets a value indicating whether to copy from InfoConnect to the RTF (Rich Text Format) Clipboard format  
     PropertyGets or sets a value indicating whether to copy from InfoConnect to the text Clipboard format  
     PropertyGets or sets a value indicating whether to copy from InfoConnect to the Unicode text Clipboard format  
     PropertyGets or sets a value indicating whether a copy (cut or append) operation puts values in unprotected input fields on the Clipboard.  
     PropertyGets or sets a value indicating whether to copy numbers from InfoConnect as text. Only affects BIFF (Binary Interchange File Format) Clipboard format.  
     PropertyGets or sets a value indicating whether the terminal copies the character spaces that trail a selection when text is copied to the Clipboard.  
     PropertyGets or sets the cursor's column location relative to the left edge of the terminal window.  
     PropertyGets or sets the cursor's row location relative to the top edge of the terminal window.  
     PropertyGets or sets a value indicating whether Cut and Clear actions replace characters with nulls or spaces.  
     PropertyGets the event numbers of all of the events currently defined in the system.  
     PropertyGets or sets a value indicating whether hotspots can be used.  
     PropertyReturns the event ID number of the last event defined using DefineEvent or the event index number of the last event defined using OnEvent.  
     PropertyGets the HotSpots object which is used to obtain/specify information pertaining to HotSpots behavior.  
     PropertyGets a value indicating whether the keyboard is locked.  
     PropertyGets or sets a value that specifies Kana Mode from the JIS-layout, which produces half-width Katakana characters.  
     PropertyGets the OIA object. OIA represents the status line on the screen.  
     PropertyGets the parent object (IIbmTerminal).  
     PropertyGets or sets a value indicating whether to align space separated data with fields on the screen.  
     PropertyGets or sets a value indicating whether to clear all of the previous data remaining in a field after pasting new data into it.  
     PropertyGets or sets a value that controls how text is pasted on a screen that has restricted locations. When true, pasting into a restricted field is skipped if the text contains an invalid entry for that field and the remaining text is pasted into subsequent fields. When false, pasting stops and the screen is locked when an attempt is made to paste an invalid entry into a restricted field. This property applies only to IBM 5250 terminal sessions.
     
     PropertyGets or sets the character that is inserted in a field on the terminal screen when data containing line breaks is copied from the Clipboard.  
     PropertyGets or sets a value indicating whether pasted text should be interpreted as a host screen image and overlaid onto the current screen starting at the current cursor position. If true, where the current screen contains an unprotected field, the source image text is pasted; where the current screen contains a protected field, the source image text is skipped. If false, the text is interpreted as a linear stream that can contain new lines and delimiters, and is pasted accordingly.  
     PropertyGets or sets a value indicating whether to move the cursor to the end of the pasted text. If False, the cursor is restored to the position it was in before text was pasted.  
     PropertyGets or sets a value indicating whether to replace tabs in the Clipboard's contents with a specified string before pasting the selection within a host application.  
     PropertyGets or sets the string that replaces tabs if the PasteReplaceTabs setting is set to true.  
     PropertyGets or sets a value indicating what happens if the terminal reaches a protected field while pasting text in the following row at the same column location where the paste began.  
     PropertyGets or sets a value indicating whether pasted text should be wrapped to the field below (instead of to the field to the right).  
     PropertyGets or sets a value indicating whether text that exceeds the current line length is pasted in the next field or truncated.  
     PropertyGets the PrintOptions object. PrintOptions holds configuration options for print emulation and print screen.  
     Property

    Gets or sets a value that controls how the PutText method places a string of characters onto the host screen. The PutText method has two modes: Mask and LinearStream.

    In Mask mode (the default), the PutText method interprets the text as a host screen image and overlays the text onto the current screen starting at the specified screen position. Where the current screen contains an unprotected field, the source string is placed in the field; where the current screen contains a protected field, that portion of the string is skipped.

    In LinearStream mode, the text is placed sequentially in unprotected fields, and remaining text that exceeds the current unprotected field's length extends into the next unprotected field(s), until all the text has been placed on the screen.

     
     PropertyGets the number of rows of the screen.  
     PropertyGets or sets time duration during which there should be no host data changes.  
     PropertyGets the area of the screen that's currently selected.  
     PropertyGets or sets options (Block or Stream) that determine the shape of a selected region.  
     PropertyGets or sets a value indicating whether the Show Bytes Remaining indicator is displayed on the host status line.  
     PropertyGets or sets a value indicating whether hotspots are visible in the terminal window.  
     PropertyGets or sets a value indicating whether operation and status messages are displayed in the Operator Information Area (OIA) at the bottom of the terminal window.  
     PropertyGets or sets a value indicating whether to show shift-out and shift-in (SO/SI) control characters on the terminal screen.  
     PropertyGets or sets a value that specifies how spaces are processed when text is copied to the Clipboard.  
    Top
    Public Methods
     NameDescription
     MethodCancels the text selection in the terminal window. If no text is selected, this method has no effect.  
     MethodLoad the hotspots file as the current hotspots definitions.  
     MethodCopies selected text to the Clipboard.  
     MethodAppends selected text to the end of the Clipboard.  
     Method

    Copies selected text to one of four clipboard buffers. If an invalid bufferNum value is specified, the request is ignored.

    Note: This property is supported only by the InfoConnect Desktop product. It is not supported by other Rocket Software products.

     
     MethodCuts selected text and copies it to the Clipboard.  
     MethodDefines a specific event. The event remains defined until it is removed with a RemoveEvent() or ClearEvent() call or the host session is closed.  
     MethodSelects all text in the terminal window between the selection start position and the specified coordinates.  
     MethodSelects a block of text in the terminal window that includes all rows between the starting row and the specified row.  
     MethodOverloaded. Locates a field starting from the specified row and column.  
     MethodGets the ScreenCharacter at the specified location.  
     MethodGets the foreground color of the character at the specified location.  
     MethodGets ScreenCharacter objects from the specified screen location. Each object represents one character.  
     MethodGets the host field that the specified row and column are part of.  
     MethodGets the foreground color of the host field that the specified row and column are part of.  
     MethodGets a host field collection that matches specifed fieldAttributes.  
     MethodGets the text of the field contained within the specified row and column.  
     MethodGets the text from the specified location.  
     MethodGets the text from the specified screen area.  
     MethodTests whether the specified screen location is a field attribute position.  
     MethodSimulates a light pen selection at the specified location in the terminal window.  
     MethodLocks the screen so that users cannot use the keyboard to provide input.  
     MethodMoves the cursor forward or back.  
     MethodOverloaded. Moves the cursor to the specified screen location.  
     MethodDefines commands to be executed when a specified event occurs during an InfoConnect session. Events defined with this method are equivalent to those defined using the Event Setup dialog box. When you save your settings file, this event becomes part of that settings file and will appear in the list of events shown in the Event Setup dialog box. Events defined by OnEvent will execute after your macro completes.You cannot use this method to accomplish actions during macro execution.  
     MethodCopies data from the Clipboard to the current cursor location.  
     MethodPastes remaining text from a previous Paste command.  
     Method

    Pastes data from one of four clipboard buffers. If an invalid bufferNum value is specified, or if the specified clipboard buffer does not contain data, the request is ignored.

    Note: This property is supported only by the InfoConnect Desktop product. It is not supported by other Rocket Software products.

     
     Method

    Pastes the contents of the Clipboard to a defined region of the current screen and, if needed, regions of subsequent screens in the host application.

     
     MethodPuts a ScreenCharacter at the specified screen location.  
     MethodOverloaded. 

    Puts text at a specified screen location, taking up the number of characters specified by the length parameter. PutText has two modes: Mask and LinearStream. These modes are set with the PutTextMaskProtectedField Property.

    In Mask mode (the default), text that coincides with protected fields is skipped and is not placed on the screen.

    In LinearStream mode, protected fields are ignored and the text is placed sequentially in unprotected fields until all of the text is placed on the screen or the specified length is exceeded.

     
     MethodRemoves a specific event that was defined via DefineEvent.  
     MethodConverts screen position in row and column to linear screen buffer index.  
     MethodGets the column value of a screen location pointed to by screenIndex.  
     MethodGets the screen coordinate of a screen location pointed to by screenIndex.  
     MethodGets the row value of a screen location pointed to by screenIndex.  
     MethodOverloaded. Searches the specified text starting from the specified screen location.  
     MethodSelects all of the text on the terminal window.  
     MethodSends a host control key to the host.  
     MethodSends a host control key to the host.  
     MethodSends the text string to the host.  
     MethodSets starting coordinates for selecting text. The default start position is the current cursor position.  
     MethodUndoes the last edit operation.  
     MethodUnlocks the screen. See the LockInput() method for more information.  
     MethodWaits for the specified duration.  
     MethodWaits for the specified control key press.  
     MethodOverloaded. Waits for the cursor to be at the specified screen location.  
     MethodWaits for host screen data to settle.  
     MethodWait for the keyboard to be enabled (unlocked and ready for additional input).  
     MethodOverloaded. Waits for the specified text to appear at the specified screen location.  
    Top
    Public Events
     NameDescription
     EventOccurs after data keys are rendered on the terminal screen.  
     EventOccurs before a control key is sent to the host.  
     EventOccurs before a data key is sent to the host.  
     EventOccurs when the cursor moves into a different field.  
     EventOccurs when the keyboard is locked.  
     EventOccurs when as the keyboard is unlocked.  
     EventThis event occurs when a session window is clicked by the mouse.  
     EventOccurs when the screen has been quiet for the time duration specified by the ScreenSettleTime property.  
     EventThis event is triggered when an event defined by the DefineEvent method occurs. Events defined in this way remain defined as long as your InfoConnect session lasts, or until they are removed using the RemoveEvent.  
     EventOccurs when host data causes the data on the screen to change.  
    Top
    See Also