Programming with Reflection

image\rwnprg32.gif WaitForSilence method

 

Syntax Found = object.WaitForSilence(SilenceTime, [Timeout], [Options])

 

Description

Wait for a specified period of datacomm "silence" (no incoming characters).

When waiting from an external application (such as stand-alone Visual Basic), the ProcessDatacomm property should be set to False to prevent Reflection from reading and processing characters between calls to Reflection methods.

Arguments

SilenceTime Argument Type: String
Required
Specifies the interval of datacomm silence to wait for. The string is specified in HH:MM:SS.hh format. If SilenceTime is 0, this method returns immediately, with Found set to True.

Timeout Argument Type: String
Optional
Specifies the amount of time to wait for the period of datacomm silence. The string is specified in HH:MM:SS.hh format. If this argument is omitted or is an empty string (""), Reflection waits forever if a sufficiently long period of silence does not occur.

Options Argument Type: Enumeration
Optional
Specifies additional, non-default behavior for the method. There are two options for this method:

 rcAllowKeystrokes

 Specifies that the user is allowed to enter keystrokes in the terminal window during the wait.

 rcNoDisplay

 Specifies that incoming datacomm characters should not be displayed in the terminal window during the wait.

 You can combine the two options using the addition operator (+): rcAllowKeystrokes + rcNoDisplay.

Return

Found Return type: Boolean
This method returns True if the specified period of datacomm silence was observed, or False if datacomm silence was not observed before the Timeout expired. If no Timeout is specified, this method cannot return False.

 

image\jump.gif Keyword Index

image\popup.gif Related Topics

image\popup.gif Reflection products that use this command