New method Fl::scheme_is(const char *name).

This is a convenience method to support easier implementation of
scheme-specific code in draw() methods and elsewhere.

Also improved Fl::scheme(const char *name) documentation.


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@10075 ea41ed52-d2ee-0310-a9c1-e6b18d33e121

1 files changed, 15 insertions, 9 deletions

diff --git a/src/Fl_get_system_colors.cxx b/src/Fl_get_system_colors.cxx
index bf158e0bc..76beda545 100644
--- a/src/Fl_get_system_colors.cxx
+++ b/src/Fl_get_system_colors.cxx
@@ -258,19 +258,25 @@ Fl_Image	*Fl::scheme_bg_ = (Fl_Image *)0;    // current background image for the
 static Fl_Pixmap	tile(tile_xpm);
 
 /**
-    Gets or sets the current widget scheme. NULL will use
-    the scheme defined in the FLTK_SCHEME environment
-    variable or the scheme resource under X11. Otherwise,
-    any of the following schemes can be used:
-      
+    Sets the current widget scheme. NULL will use the scheme defined
+    in the FLTK_SCHEME environment variable or the scheme resource
+    under X11. Otherwise, any of the following schemes can be used:
+
     	- "none" - This is the default look-n-feel which resembles old
     	Windows (95/98/Me/NT/2000) and old GTK/KDE
-    
+
+    	- "base" - This is an alias for "none"
+
     	- "plastic" - This scheme is inspired by the Aqua user interface
     	on Mac OS X
-    
-    	- "gtk+" - This scheme is inspired by the Red Hat Bluecurve
-    	theme
+
+    	- "gtk+" - This scheme is inspired by the Red Hat Bluecurve theme
+
+    Uppercase scheme names are equivalent, but the stored scheme name will
+    always be lowercase and Fl::scheme() will return this lowercase name.
+
+    If the resulting scheme name is not defined, the default scheme will
+    be used and Fl::scheme() will return NULL.
 */
 int Fl::scheme(const char *s) {
   if (!s) {