Reflection
ITerminal Interface Members
Properties  Methods  Events

The following tables list the members exposed by ITerminal.

Public Properties
 NameDescription
 PropertyAllowColorTableChangesGets or sets whether Reflection responds to host commands that are related to color table changes.  
 PropertyAllowJISGets or sets whether JIS escape sequences are allowed when other host character sets are selected.  
 PropertyAnswerBackGets or sets a string that is sent to the host when Reflection receives an Enq character from the host.  
 PropertyAutoAnswerbackGet or set whether the answerback message (set with the AnswerBack property) is automatically sent to the host after a communications line connection.  
 PropertyAutoConnectGets or sets a value that specifes whether to attempt to establish a host connection as soon as the current settings file is loaded.  
 PropertyBellEnabledGets or sets whether a bell sounds when the ASCII bell character (decimal 7) is transmitted from the keyboard or received from the host.  
 PropertyBlockTerminatorGets or sets a block terminator character to be transmitted at the end of each block data transmission.  
 PropertyCacheSecureShellUserName

Gets or sets whether Reflection caches the user name entered for a Secure Shell session.

 
 PropertyCharacterSetTranslationEnabledGets or sets the character set translation state.  
 PropertyCitrixIPAddressGets the IP address for a connection to a Citrix host.  
 PropertyCitrixPCNameGets the PC name returned by a Citrix host.  
 PropertyCitrixUserNameGets the Username value for a Citrix connection type.  
 PropertyClearDisplayOnDisconnectGet or set how Reflection handles the display memory when you disconnect from the host.  
 PropertyCodePageGets the current DOS code page.  
 PropertyConnectionErrorGets the error number that describes the specific cause of the most recent general connection failure (only when the last returned error has the value ErrConnectionError).  
 PropertyConnectionErrorMessageGets the text string that describes the specific cause of the most recent general connection failure (only when the last returned error has the value ErrConnectionError).  
 PropertyConnectionIDGet the integer value that uniquely identifies the current connection.  
 PropertyConnectionSettingsGets the IConnectionSettings object.  
 PropertyConnectionTimeVisibleGets or sets whether the Reflection status bar displays the length of time you have been connected to a host.  
 PropertyConnectionTypeGets or sets the connection type.  
 PropertyContextMenusGets the ContextMenus object.  
 PropertyDASOApplicationIDRetrieves or assigns the application ID to use for DASO (Digital Certificate Access Server Automated Sign On) support.  
 PropertyDASOPassTicketRetrieves the pass ticket for DASO (Digital Certificate Access Server Automated Sign On). This field will be empty until a successful call to GetDASOPassTicket is executed.  
 PropertyDASOSessionNameRetrieves the session name that is used for DASO (Digital Certificate Access Server Automated Sign On). The session name and DASO application ID are used by the DASO server when mapping the current user to RACF logon credentials for host access.  
 PropertyDASOUserIDRetrieves the RACF USERID for DASO (Digital Certificate Access Server Automated Sign On). This field will be empty until a successful call to GetDASOPassTicket is executed.  
 PropertyDataStreamTranslationGets or sets whether Reflection translates characters from the host to the PC, and vice versa, using the current translation table.  
 PropertyDefaultHostSettingsGets or sets whether Reflection uses default settings appropriate to a UNIX or OpenVMS host.  
 PropertyDefaultPrinterGets or sets the default printer to which Reflection sends printer output.  
 PropertyDeviceResponseGets or sets how Reflection responds to a primary device attribute request from the host (usually when logging on).  
 PropertyElfAtochemEmulationGets or sets whether Elf Autochem terminal emulation is enabled.  
 PropertyEnquireAcknowledgeGets or sets whether Reflection uses a form of handshaking called Enquire Acknowledge (EnqAck).  
 PropertyEnterKeyConnectsGets or sets how Reflection responds if the ENTER key is pressed when not connected to a host.  
 PropertyFileTransferGets the FileTransfer object.  
 PropertyForceC1ControlsGets or sets whether Reflection interprets character codes in certain host character sets.  
 PropertyGraphicsDestinationGets or sets the destination of graphics when you print using the ReGIS hard copy command.  
 PropertyGraphicsFixScreenGets or sets whether the onscreen graphic is periodically updated from the offscreen graphic.  
 PropertyGraphicsLevelUse this property to match Reflection to the capabilities of a digital printer with regard to aspect ratio, horizontal grid size, background printing, and color printing.  
 PropertyGraphicsOutputCursorGets or sets whether the graphics output cursor is displayed.  
 PropertyGraphicsPrintModeGets or sets how graphics images are printed.  
 PropertyGraphicsScrollingGets or sets whether sixel images are scrolled.  
 PropertyGraphicsTerminalTypeGets ors set which terminal is emulated, and how many shades or colors are available in ReGIS.  
 PropertyHorizontalCouplingGets or sets whether the column in which the cursor is located remains in the terminal window regardless of how the terminal window is resized, or which screen font size is used.  
 PropertyHorizontalScrollBarVisibleGets or sets whether the horizontal scroll bar is visible.  
 PropertyHostCharacterSetGets or sets the host character set that Reflection uses when transmitting and receiving characters.  
 PropertyHostDescriptionFileNameGets or sets the name and location of the host description file that is used by the GetHostElement method.  
 PropertyHostsFileGets or sets the file path for the file that is used to populate the Host name/IP Address Drop-down list on the Create New VT Document dialog box.  
 PropertyHostStatusLineGets or sets the current host status line display.  
 PropertyHostTriggerCharacterGets or sets the host trigger character value.  
 PropertyIsConnectedGets the value that indicates whether Reflection is connected.  
 PropertyIsDataCarrierHighGet whether the data carrier signal is high. Relevant only for serial connections.  
 PropertyIsGraphicsSupportedGets the "graphics supported" flag.  
 PropertyIsWinMASSSupportedGets or sets whether WinMASS software support is enabled.  
 PropertyKeyboardMapperGets the KeyboardMapper object.  
 PropertyLocalEchoGets or sets whether the local computer "echoes" typed characters directly to the screen.  
 PropertyLogToSerialDeviceGets or sets whether data logged by the terminal is sent to the currently configured serial device.  
 PropertyMacroGets the Macro object.  
 PropertyMacrographReportsEnabledGets or sets whether macrograph reporting is enabled.  
 PropertyMappedNumLockPreservesNumLockGets or sets how Reflection responds to a NUM LOCK key press on the PC when it is mapped to emulate the action of a terminal key.  
 PropertyMouseMapperGets the MouseMapper object.  
 PropertyMouseShapeGets or sets the appearance of the mouse pointer in the terminal window.  
 PropertyNationalReplacementSetGets or sets the set of character translations that occur between the local computer and the host in 7-bit mode.  
 PropertyNRCEnabledGets or sets whether the translations specified by the NationalReplacementSet property are performed.  
 PropertyOnLineGets or sets whether Reflection is in remote mode or local mode.  
 PropertyPreserveNRCGets or sets Digital terminals reset national replacement mode when a soft reset occurs.  
 PropertyProcessDataCommGets or sets whether Reflection processes incoming characters between calls to Reflection methods.  
 PropertyProcessInvalidKeystrokesGets or sets how Reflection handles invalid keystrokes.  
 PropertyProductivityGets the Productivity object.  
 PropertyReGISAlwaysGraphicsModeGets or sets ReGIS Graphics mode.  
 PropertyReGISBufferSizeGets or sets the size of the buffer reserved for caching ReGIS graphics.  
 PropertyReGISV6Gets or sets how ReGIS graphics are handled.  
 PropertySaveScrollingRegionGets or sets a save state for the scrolling region.  
 PropertySaveSecureShellUserNameGets or sets whether Reflection saves the user name when you save your settings files or record a connection macro.  
 PropertySaveSessionOnCloseGets or sets a close option, which indicates how to handle the save action when closing the control.  
 PropertyScreenGets the Screen object.  
 PropertySendKeyboardModifierPrefixGets or sets whether a SHIFT, CTRL, or ALT key press sends an escape sequence and, if the key is pressed in conjunction with other keys, prefixes the escape sequence to outbound data, in VT-UTF8 emulations.  
 PropertySerialDevicePortGets or sets the serial port on the PC that is used as the terminal serial device port.  
 PropertySerialDeviceSettingsGets or sets the configuration parameters for the currently configured serial printer port.  
 PropertySerialDeviceToHostGets or sets whether data received from the currently configured serial device port is sent to the host.  
 PropertySessionLimitsNSVTGets or sets the maximum allowable number of simultaneous VT-MGR sessions.  
 PropertySessionLimitsRloginGets or sets the maximum allowable number of simultaneous Rlogin sessions.  
 PropertySessionLimitsSecureShellGets or sets the maximum allowable number of simultaneous SecureShell sessions.  
 PropertySessionLimitsTelnetGets or sets the maximum allowable number of simultaneous Telnet sessions.  
 PropertySingleByteUPSSGets or sets which Digital UPS character set that is used when SET HOST-CHARACTER-SET is set to a double-byte character set.  
 PropertyStartupConnectionGets or sets the saved connection that is used when the StartupAction property is set to UseSavedConnection.  
 PropertyStatusLineTextGets or sets the current status line text.  
 PropertyTAPIVersionGets or sets the Telephony Application Programming Interface (TAPI) that Reflection uses to connect the PC to telephone services.  
 PropertyTerminalSoundGets or sets how beeps sound in Reflection.  
 PropertyTerminalTypeGets or sets the terminal that Reflection is to emulate.  
 PropertyTerminalUserControlContextThis is an internal property used to determine the context of this terminal object usage. This is set to true if this terminal object is being used in a Terminal User Control context.  
 PropertyTextFileCharacterSetGets or sets whether Reflection uses the ASCII or ANSI character set.  
 PropertyThemeGets the Theme object.  
 PropertyTimeSinceConnectedGet the time (in seconds) during which you have been connected.  
 PropertyTraceFileNameGet or set the name of the trace file that is created when Trace Session Start is true.  
 PropertyTraceFolderGets or sets the location of the folder where Reflection saves trace files that are created when Trace Session Start is true.  
 PropertyTraceSessionStartGets or sets the Reflection Trace utility to begin tracing the moment Reflection starts.  
 PropertyUiControlActionMapperGets the object used to map actions to the user interface control and to retrieve the action sequence from the user interface control.  
 PropertyUseIPv6Gets or sets how Reflection communicates with a host using the IPv6 and older IPv4 protocols.  
 PropertyUseModemDialerV5Gets or sets which modem dialer is used to make modem connections.  
 PropertyUserDataGets or sets data for the duration of the current Reflection session.  
 PropertyUserDefinedKeysLockedGets or sets whether the host can alter the definitions of the user-defined keys.  
 PropertyUserFeaturesLockedGets or sets whether certain features can be changed by the host.  
 PropertyVBCommonProjectCommon VB Project (VBA use only)  
 PropertyVBProjectVB Project (VBA use only)  
 PropertyVersionGets the version of the terminal session control.  
 PropertyVerticalScrollBarVisibleGets or sets whether the vertical scroll bar is visible.  
 PropertyVT640CompatibleGets or sets whether Reflection switches back and forth automatically between Tektronix and VT terminal emulation when it receives VT640-compatible control characters from the host.  
 PropertyVTTekGets or sets VT340 Tektronix state.  
 PropertyWeakDeviceControlStringGets or sets the device control string state.  
 PropertyWindowRowsGets or sets the number of lines displayed on screen.  
 PropertyWTSIPAddressGets the IP address returned by Windows Terminal Server (WTS).  
 PropertyWTSPCNameGets the PC name returned by Windows Terminal Server (WTS).  
 PropertyWTSUserNameGets the user name returned by Windows Terminal Server (WTS).  
 PropertyWyseAcceptNullsGets or sets whether the terminal accepts nulls from the host(for Wyse terminal emulation only).  
Top
Public Methods
 NameDescription
 MethodCloseCloses the terminal session with the close option.  
 MethodCloseAllConnectionsCloses all connections established by the current copy of Reflection.  
 MethodConnectConnects to the host. It is ignored if a connection already exists.  
 MethodDialOverloaded. Dials a modem. This method is only valid if Reflection is set to use the old modem dialer (UseModemDialerV5 = true).  
 MethodDisconnectDisconnects from the host. If no connection currently exists, this method is ignored.  
 MethodExecuteExecute a given action. Actions possible is defined in InputMapActionID.  
 MethodGetDASOPassTicketIssues a request to the Reflection Security Gateway for a DASO pass ticket. On success, the DASOUserID and DASOPassTicket properties will be valid and can be used for automated sign on to the host. The application ID can be preset using the DASOApplicationID property in which case the ApplicationID parameter on this call may be empty.  
 MethodGetSerialConnectionStatisticsReturns a statistic for a serial connection.  
 MethodHangUpHangs up the modem by sending the Hayes "+++" command to get the modem's attention, followed by the "ATH" hangup command.  
 MethodOpenSettingsOpens a setting file.  
 MethodProcessTraceProcess a tracefile created by StartTrace()/StopTrace().  
 MethodResetTerminalExecutes a terminal reset.  
 MethodRestoreDefaultRestores the session settings to the default settings as specified by the restore option value.  
 MethodResumeConnectionResumes a previously suspended connection (suspend connections with the SuspendConnection method).  
 MethodSaveSaves all settings.  
 MethodSaveAsSaves all settings to the specified file.  
 MethodStartLoggingStart logging terminal activity.  
 MethodStartTraceStarts capturing data coming from the host to a disk file.  
 MethodStopLoggingStop logging terminal activity.  
 MethodStopTerminalInstanceFor internal use. Used when a Terminal User Control is being shut down.  
 MethodStopTraceStops capturing incoming host data to a file and closes the trace file.  
 MethodSuspendCurrentConnectionSuspends the current host connection (so that it can be resumed later with ResumeConnection).  
 MethodWaitForCallOverloaded. Initializes the modem to automatically answer an incoming call and opens a status dialog box until a connection is established.  
Top
Public Events
 NameDescription
 EventClosedThis event occurs before the session closes.  
 EventClosingThis event occurs when the request to close the session has been made.  
 EventConnectedThe event occurs after the connection to the host has been made.  
 EventConnectingThis event is triggered immediately before a connection is made.  
 EventConnectionResumedThis event is triggered when the suspended connection to the host has been resumed.  
 EventConnectionSuspendedThis event is triggered when the connection to the host has been suspended.  
 EventCreditCardRecognized

This event occurs when an unredacted Primary Account Number (PAN) is copied from the terminal (for example, when the PAN is copied to the clipboard).

This event is enabled by configuring settings on the Setup Information Privacy dialog box. For more information, see "Monitor Credit Card Access" in the Reflection .NET API Guide.

 
 EventDisconnectedThe event occurs after the connection to the host has been disconnected.  
 EventSettingsLoadedThis event is triggered immediately after a settings file is opened.  
 EventSettingsLoadingThis event is triggered immediately before a settings file is opened.  
 EventUserDisconnectingThis event is triggered before Reflection disconnects from the host.  
Top
See Also