Dial method
Programming with Reflection
Dial method
Syntax object.Dial PhoneNumber, [Description], [InitString], [AnswerTimeout], [RetryTimes], [RetryInterval], [SpeakerMode], [SpeakerVolume], [SpeakerOffAfterRedial], [IgnoreModemErrors]
Dials a modem. This method is only valid if Reflection is set to use the old modem dialer (UseModemDialerV5 = True).
PhoneNumber Argument type: String
Required
The phone number to dial. The string can contain any valid modem dialing characters, such as commas (to allow dialing to pause for two seconds per comma) and hyphens and parentheses (used as separators for better readability). The string should not include any AT commands or dialing prefix commands; these settings should be made in the Dialing Options dialog box from the Connection Setup dialog box.
Description Argument Type: String
Optional
Description to be displayed in the "Dialing In Progress" dialog box. If this option is omitted, only the phone number appears in the dialog box.
InitString Argument Type: String
Optional
String to be sent to the modem before dialing. If omitted, Reflection uses the default initialization string configured in the Configure Modem dialog box.
AnswerTimeout Argument Type: String
Optional
Specifies the amount of time to wait for the host to confirm the connection. The string is specified in HH:MM:SS.hh format. A time string of "0" causes Reflection to wait forever. If this argument is omitted or is empty (""), the default timeout (60 seconds) is used.
RetryTimes Argument Type: Integer
Optional
Specifies the number of times to redial if the number is busy or does not answer. If omitted, Reflection uses the default value (one retry).
RetryInterval Argument Type: String
Optional
Specifies the amount of time to wait before redialing. The string is specified in HH:MM:SS.hh format. If this argument is omitted or is empty (""), the default timeout is used (120 seconds).
SpeakerMode Argument Type: Enumeration
Optional
Specifies the speaker mode. The default is rcSpeakerDialing. The possible values are:
rcSpeakerOn
Modem speaker is always on.
rcSpeakerOff
Modem speaker is always off.
rcSpeakerDialing
Modem speaker is on during dialing.
SpeakerVolume Argument Type: Enumeration
Optional
Specifies the speaker volume. The default is rcSpeakerMedium. The possible values are:
rcSpeakerLow
Modem speaker volume is low.
rcSpeakerMedium
Modem speaker volume is medium.
rcSpeakerHigh
Modem speaker volume is high.
SpeakerOffAfterRedial
Argument Type: Boolean
Optional
If True, the modem speaker is turned off after the first dialing attempt. If False (default) or omitted, the modem speaker remains set to the SpeakerMode for each dialing attempt.
IgnoreModemErrors
Argument Type: Boolean
Optional
If True, Reflection ignores modem initialization string errors. If False, these errors are displayed in a message box.
Example
Related Topics