VCSound


Version:

5.0

Description:

Play a Visual CADD™ sound

Declaration:

 

C/C++

extern "C" void WINAPI VCSound(UINT Sound)

Delphi

procedure VCSound(var Sound: smallint); far

ActiveX/COM

Sub Sound(ByVal Sound As UINT)

Parameters:

 

Sound - the Visual CADD™ sound to play; one of the following:

SND_CRITICAL - a critical error has occured

SND_TOOLERROR - the current tool has encountered an error

SND_TOOLDONE - the current tool has completed successfully

SND_ABORT  - the current tool has been aborted

SND_ALERT - user attention is required

SND_INPUT - there is an error in the current input, i.e. invalid key, invalid char, etc.

SND_DEBUG - used for internal debug purposes

SND_STARTUP - used only on start up of VCADD

Notes:

Visual CADD™ has several sounds which can be used to signal the user.  The .wav files associated with each sound are determined by registry entries and can be edited by the user through the Windows Control Panel.

Any sound can be used at any time, however to avoid confusing the user, sounds should be used for their designated purpose. 

The sounds used are specific to each application.  If you are calling VCSound from a DLL which has been called from VCADD32.EXE, then the Visual CADD™ sounds can be used.  When called from an application other than VCADD32.EXE, the application must define its own sounds using VCInitSounds.  For further information see the documentation for the Windows API call PlaySound.
 

See Also:

VCInitSounds