Programming with Reflection

image\rwnprg32.gif WaitUntil method

 

Syntax object.WaitUntil DateTime, [Options]

 

Description

Waits until a specific date and time. Incoming data is processed during the wait.

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

DateTime Argument Type: Date/Time
Required
Specifies when the wait should end. If you specify a time but not a date, Reflection Basic assumes the current date.

If you supply a time without a date, Reflection Basic waits until the specified time on the current day. If the time has already passed, the wait is satisfied immediately—it does not wait until the specified time on the following day.

You can use a "date literal" as the value for this argument. A date literal is enclosed in pound signs (#) and can be in any "human-readable" format. For example:

 #January 1, 1997 10:00#
#1/1/97 23:13#
#10:15am#

 If you don't specify a date, Reflection Basic assumes the current date.

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.

 

image\jump.gif Example

image\jump.gif Keyword Index

image\popup.gif Related Topics

image\popup.gif Reflection products that use this command