Play Windows Sound

Added November 2017

? tab(-10, AG_MESSAGEBEEP); soundcode; chr(127);

AG_MESSAGEBEEP (3) sends a request to Windows to play the sound (wave form file) corresponding to the specified soundcode. If soundcode is not specified, the default sound—a simple beep—is generated. Note that you can change the wave forms associated with the various sounds in the Control Panel.

If specified, soundcode must be a single ASCII byte whose value is 32 + plus the value of one of the symbols in the table below, which are also used for specifying the icons in the standard Windows message box; see AG_MESSAGEBOXSTD and MSGBOX.SBR. If soundcode is not specified, the default simple beep sound will be requested.

Symbol

Value

Description*

MBICON_STOP

&h0010

Windows Critical Stop

MBICON_QUESTION

&h0020

Windows Question

MBICON_EXCLAMATION

&h0030

Windows Exclamation

MBICON_ICON

&h0040

Windows Asterisk

 

Note that the sounds mentioned in the Description column of the table are all standard Windows sounds. See the Sounds applet in Windows Control Panel for more information.

Examples

? tab(-10,AG_MESSAGEBEEP); chr(127);                       ! default simple beep

? tab(-10,AG_MESSAGEBEEP); chr(32+MBICON_STOP); chr(127);  ! critical stop

 

See Also

•   Play Sound File