The Support Kit

System Beep

Declared in: support/Beep.h

Two new system beep functions:

• add_system_beep_event() lets you register a "system beep event." A system beep event is registered and identified by name.

• system_beep() plays the soundfile that's associated with the named system beep event.

The user is responsible for associating a system beep event with a soundfile; this is done through the Sounds preference. You can associate an event with a soundfile programmatically by using a BMediaFiles object; note that the API defined in Beep.h doesn't help in this regard.

Currently, the BeOS defines three system beep events: "Startup", "Beep", and "New E-mail". If you pass NULL to system_beep(), the "Beep" sound is played.

The old beep() function is supported, but deprecated. beep() is now a cover for

    system_beep(NULL)