procedure Dial(ANumber : string);
Dials the specified telephone number.
Dial initializes the modem and then dials the number specified by the ANumber parameter. When the connection is established, the OnModemConnected event is generated.
Several TApxDataPackets are initialized to detect modem responses during initialization and to monitor connection progress.
Dial returns immediately. The OnModemConnect event is generated when the appropriate connection responses have been received from the modem. The OnModemFail event is generated if the modem could not be initialized, could not detect dial tone (if that was required by the configuration), if the modems could not negotiate a mutually acceptable set of connection parameters, or if the remote party did not answer the call within DialTimeout seconds. The FailureCode property can be queried to determine the actual reason for the failure.
A dial operation can be cancelled at any time by calling CancelCall.
The ANumber parameter to this event should contain all parameters required for your modem to dial the number. This includes any prefixes required by your phone system to obtain an outside line. For example, if your phone system requires you to dial '9' to get an outside line, the call to Dial would include that digit:
ApxModem1.Dial('9 555-1212');
See also: AutoAnswer, CancelCall, ConfigAndOpen, DialTimeout, OnModemConnect, OnModemFail, StatusDisplay