Home
The HyperCard Center
HyperTalk Reference

Note: This is a work in progress and many formatting issues have been fixed. Read more about the project on the home page.

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

Related Topics

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)

Made with Macintosh

Switch to Retro View