# AG\_MESSAGEBEEP

> [HTML Version](ag_messagebeep.htm)

_Reviewed and revised December 2023_

**tab(-10, AG\_MESSAGEBEEP); soundcode; chr(127);**     [Tab(-10,x) Syntax Notes](ag_xxx_syntax-notes.htm.md)

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](ag_messageboxstd.htm.md) and [MSGBOX](msgboxsbr.htm.md)[xs](keyword-types.htm.md). 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**

•	[Play Sound File](ag_playsound.htm.md)