From 17374b20bb7bc6230170e341105bed9f2e4e3b05 Mon Sep 17 00:00:00 2001
From: Michael R Sweet <michael.r.sweet@gmail.com>
Date: Tue, 9 Apr 2002 09:38:15 +0000
Subject: Update fl_beep() to use the PC speaker for FL_BEEP_DEFAULT.

Add docos for fl_beep...


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@2059 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
---
 CHANGES                      |  2 ++
 documentation/functions.html | 34 +++++++++++++++++++++++++++++++---
 src/fl_ask.cxx               | 11 +++++++----
 3 files changed, 40 insertions(+), 7 deletions(-)

diff --git a/CHANGES b/CHANGES
index dfc75f845..f5812e467 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,5 +1,7 @@
 CHANGES IN FLTK 1.1.0b13
 
+	- fl_beep(FL_BEEP_DEFAULT) now uses the PC speaker under
+	  Windows (0xFFFFFFFF) rather than an event sound.
 	- The configure script didn't include the -mwindows or
 	  -DWIN32 compiler options in the output of fltk-config
 	  when using the Cygwin tools.
diff --git a/documentation/functions.html b/documentation/functions.html
index 4a8f827e9..e999f4214 100644
--- a/documentation/functions.html
+++ b/documentation/functions.html
@@ -8,13 +8,41 @@ A</A>.
 
 <h2>Functions</h2>
 
+<h3><A name="fl_beep">void fl_beep(int type = FL_BEEP_DEFAULT)</A></h3>
+
+<P>Sounds an audible notification; the default <CODE>type</CODE> argument
+sounds a simple "beep" sound. Other values for <CODE>type</CODE> may use
+a system or user-defined sound file:
+
+<UL>
+
+	<LI><TT>FL_BEEP_DEFAULT</TT> - Make a generic "beep" sound.
+
+	<LI><TT>FL_BEEP_MESSAGE</TT> - Make a sound appropriate for an
+	informational message.
+
+	<LI><TT>FL_BEEP_ERROR</TT> - Make a sound appropriate for an
+	error message.
+
+	<LI><TT>FL_BEEP_QUESTION</TT> - Make a sound appropriate for
+	a question.
+
+	<LI><TT>FL_BEEP_PASSWORD</TT> - Make a sound appropriate for
+	a password prompt.
+
+	<LI><TT>FL_BEEP_NOTIFICATION</TT> - Make a sound appropriate for
+	an event notification ("you have mail", etc.)
+
+</UL>
+
 <h3><A name="fl_color_chooser_func">int fl_color_chooser(const char
 *title, double &amp;r, double &amp;g, double &amp;b)
 <br>int fl_color_chooser(const char *title, uchar &amp;r, uchar &amp;g, uchar &amp;b)</A></h3>
 
-The double version takes RGB values in the range 0.0 to 1.0.  The
-uchar version takes RGB values in the range 0 to 255. The <tt>title</tt>
-argument specifies the label (title) for the window.
+<P>The <CODE>double</CODE> version takes RGB values in the range
+0.0 to 1.0.  The <CODE>uchar</CODE> version takes RGB values in
+the range 0 to 255. The <tt>title</tt> argument specifies the
+label (title) for the window.
 
 <p align=center><img src="fl_color_chooser.jpg" ALT="The fl_color_chooser dialog.">
 
diff --git a/src/fl_ask.cxx b/src/fl_ask.cxx
index cc83f5a4f..4e1a6ab74 100644
--- a/src/fl_ask.cxx
+++ b/src/fl_ask.cxx
@@ -1,5 +1,5 @@
 //
-// "$Id: fl_ask.cxx,v 1.8.2.8.2.7 2002/04/02 19:30:52 easysw Exp $"
+// "$Id: fl_ask.cxx,v 1.8.2.8.2.8 2002/04/09 09:38:15 easysw Exp $"
 //
 // Standard dialog functions for the Fast Light Tool Kit (FLTK).
 //
@@ -222,15 +222,18 @@ void fl_beep(int type) {
     case FL_BEEP_NOTIFICATION :
       MessageBeep(MB_ICONASTERISK);
       break;
-    default :
+    case FL_BEEP_ERROR :
       MessageBeep(MB_ICONERROR);
       break;
+    default :
+      MessageBeep(0xFFFFFFFF);
+      break;
   }
 #elif defined(__APPLE__)
   switch (type) {
     case FL_BEEP_DEFAULT :
     case FL_BEEP_ERROR :
-      SysBeep( 30 );
+      SysBeep(30);
       break;
     default :
       break;
@@ -340,5 +343,5 @@ const char *fl_password(const char *fmt, const char *defstr, ...) {
 }
 
 //
-// End of "$Id: fl_ask.cxx,v 1.8.2.8.2.7 2002/04/02 19:30:52 easysw Exp $".
+// End of "$Id: fl_ask.cxx,v 1.8.2.8.2.8 2002/04/09 09:38:15 easysw Exp $".
 //
-- 
cgit v1.2.3