Legacy Document

Inside Macintosh: Macintosh Toolbox Essentials /

Chapter 6 - Dialog Manager / Dialog Manager Reference

Dialog Manager Routines / Initializing the Dialog Manager

ErrorSound

To use your own alert sound instead of the system alert sound for signaling the user, use the ErrorSound procedure.

PROCEDURE ErrorSound (soundProc: SoundProcPtr);

soundProc

A pointer to a procedure that generates the desired alert sounds.

DESCRIPTION

The Dialog Manager uses the system alert sound for signaling the user during various alert stages. The system alert sound, which is a sound resource stored in the System
file, is played whenever system software or your application uses the Sound Manager procedure SysBeep. By changing the setting in the Sound control panel, the user can determine which sound is played. If you want to use sounds other than the system
alert sound at various alert stages, write your own sound procedure and call the ErrorSound procedure to make it the current sound procedure.

SPECIAL CONSIDERATIONS

If you pass NIL in the soundProc parameter, the Dialog Manager neither plays sounds nor causes the menu bar to blink, and thus the user receives no signal.

SEE ALSO

See the description of MyAlertSound on page 6-137 for a discussion of how to write
the sound procedure pointed to by the soundProc parameter. For examples of how to incorporate sound alerts into alert stages, see Listing 6-2 on page 6-21 and Listing 6-3 on page 6-22.