ProcessDataComm Property

Gets or sets whether Reflection processes incoming characters between calls to Reflection methods.
Property ProcessDataComm As Boolean
Dim instance As ITerminal
Dim value As Boolean
instance.ProcessDataComm = value
value = instance.ProcessDataComm
bool ProcessDataComm {get; set;}

Property Value

The default value is true.

Regardless of the current value of ProcessDataComm, when Reflection runs a macro or script, data from the host is processed only if the macro includes methods (such as WaitForString) that explicity handle incoming data. Data not handled explicitly in the macro is not processed until the macro terminates.

Do not use this property unless you are controlling Reflection from an external application using Automation.

When this property is set to false, Reflection only processes incoming datacomm characters during an explicit call to a method that reads datacomm (such as ReadChars, ReadLine, or WaitForString). Reflection does not process incoming unless it is instructed to do so. The data will sit in a queue until one of the Reflection methods that explicitly processes this data (such as WaitForString)

is executed.

In addition, an external program has exclusive access to the incoming datastream, ensuring that no incoming characters are lost. For example, if the controlling program is logging on, it is important that Reflection does not process the incoming data after a Transmit method but before the subsequent WaitForString method. So the controlling program must set ProcessDataComm to false to assure that the logon works correctly. However, if the controlling program wants the user to interact directly with a host application, it must set ProcessDataComm to true to allow that user interaction.

When this property is set to true (the default), Reflection processes incoming data just as a terminal would.

See Also