dial

dial posInteger

dial posInteger with modem ¬

       [modemCommands]

The dial command generates touch-tone sounds for the digits in posInteger through the Macintosh speaker. To dial the phone from HyperCard, you must either hold the handset up to the speaker of your Macintosh or use a device that feeds Macintosh audio output to the telephone.

If you use the with modem option, HyperCard sets up calls using the modem connected to the modem port. For more information about using modems with HyperCard, see the Phone Dialer stack. See your modem manual for valid modemCommands.

Note: If you include a hyphen in the number, place the entire expression in quotation marks. Otherwise, HyperCard performs a subtraction before dialing the number.

Examples

ask "Enter a phone number:"

if it is not empty then dial it

dial myHomeComputer -- if myHomeComputer contains a number

dial "415-555-1212"

dial "999-973-6000" with modem

dial "999-996-1010" with modem "ATS0=0S7=1DT"  -- depends on your modem

Demo Script

on mouseUp

 dial "(123) 456-7890"

end mouseUp

Placeholders

posInteger

An expression that evaluates to a positive integer.

For example:

3

67 mod 13

the number of bg fields

the number of backgrounds

the number of cards div 2

See also: background, bkgnd, button, card, chunk, field, menu, and menuItem

modemCommands

A text expression that is a valid modem command for your modem.

Here are some examples for Hayes-compatible modems:

"ATS0=0S7=1DT"

"ATS0=0DT"

HyperTalk Reference

Version 0.8b4 (July 4, 2025)