Please enable JavaScript to view this site.

A-Shell Reference

Reviewed and revised December 2023

tab(-10, AG_MESSAGEBEEP); soundcode; chr(127);     Tab(-10,x) Syntax Notes

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. 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.

Response

none

Examples

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

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

 

See Also