FLTK logo

[master] 360040d - Improve Fl_Menu_Item docs and inline deprecated methods

FLTK matrix user chat room
(using Element browser app)   FLTK gitter user chat room   GitHub FLTK Project   FLTK News RSS Feed  
  FLTK Apps      FLTK Library      Forums      Links     Login 
 All Forums  |  Back to fltk.commit  ]
 
Previous Message ]Next Message ]

[master] 360040d - Improve Fl_Menu_Item docs and inline deprecated methods "Albrecht Schlosser" Sep 18, 2020  
 
commit 360040d0bff21f13ed36637810c8bdf71b4abf5a
Author:     Albrecht Schlosser <albrechts.fltk@online.de>
AuthorDate: Fri Sep 18 17:17:36 2020 +0200
Commit:     Albrecht Schlosser <albrechts.fltk@online.de>
CommitDate: Fri Sep 18 17:17:36 2020 +0200

    Improve Fl_Menu_Item docs and inline deprecated methods
    
    The deprecated methods are now calling the new methods to be
    entirely compatible.
    
    These methods should be removed in 1.5.0
    
    (fix unrelated whitespace as well)

 FL/Fl_Menu_Item.H        | 52 +++++++++++++++++++++++++++++-------------------
 src/Fl_Image_Surface.cxx |  2 +-
 2 files changed, 32 insertions(+), 22 deletions(-)

diff --git FL/Fl_Menu_Item.H FL/Fl_Menu_Item.H
index 0c97e53..435f738 100644
--- FL/Fl_Menu_Item.H
+++ FL/Fl_Menu_Item.H
@@ -1,7 +1,7 @@
 //
 // Menu item header file for the Fast Light Tool Kit (FLTK).
 //
-// Copyright 1998-2010 by Bill Spitzak and others.
+// Copyright 1998-2020 by Bill Spitzak and others.
 //
 // This library is free software. Distribution and use rights are outlined in
 // the file "COPYING" which should have been included with this file.  If this
@@ -25,15 +25,15 @@
 /// @file
 
 enum { // values for flags:
-  FL_MENU_INACTIVE = 1,         ///< Deactivate menu item (gray out)
-  FL_MENU_TOGGLE= 2,            ///< Item is a checkbox toggle (shows checkbox for on/off state)
-  FL_MENU_VALUE = 4,            ///< The on/off state for checkbox/radio buttons (if set, state is 'on')
-  FL_MENU_RADIO = 8,            ///< Item is a radio button (one checkbox of many can be on)
-  FL_MENU_INVISIBLE = 0x10,     ///< Item will not show up (shortcut will work)
-  FL_SUBMENU_POINTER = 0x20,    ///< Indicates user_data() is a pointer to another menu array
-  FL_SUBMENU = 0x40,            ///< This item is a submenu to other items
-  FL_MENU_DIVIDER = 0x80,       ///< Creates divider line below this item. Also ends a group of radio buttons.
-  FL_MENU_HORIZONTAL = 0x100    ///< ??? -- reserved
+  FL_MENU_INACTIVE   = 1,      ///< Deactivate menu item (gray out)
+  FL_MENU_TOGGLE     = 2,      ///< Item is a checkbox toggle (shows checkbox for on/off state)
+  FL_MENU_VALUE      = 4,      ///< The on/off state for checkbox/radio buttons (if set, state is 'on')
+  FL_MENU_RADIO      = 8,      ///< Item is a radio button (one checkbox of many can be on)
+  FL_MENU_INVISIBLE  = 0x10,   ///< Item will not show up (shortcut will work)
+  FL_SUBMENU_POINTER = 0x20,   ///< Indicates user_data() is a pointer to another menu array
+  FL_SUBMENU         = 0x40,   ///< Item is a submenu to other items
+  FL_MENU_DIVIDER    = 0x80,   ///< Creates divider line below this item. Also ends a group of radio buttons
+  FL_MENU_HORIZONTAL = 0x100   ///< ??? -- reserved
 };
 
 extern FL_EXPORT Fl_Shortcut fl_old_shortcut(const char*);
@@ -402,19 +402,29 @@ struct FL_EXPORT Fl_Menu_Item {
   */
   void do_callback(Fl_Widget* o,long arg) const {callback_(o, (void*)(fl_intptr_t)arg);}
 
-  // back-compatibility, do not use:
-
-  /** For back compatibility only
-   \deprecated  Replaced by value() */
-  int checked() const {return flags&FL_MENU_VALUE;}
+  /** Back compatibility only.
+    \deprecated
+      Please use Fl_Menu_Item::value() instead.
+      This method will be removed in FLTK 1.5.0 or later.
+    \see value()
+  */
+  inline int checked() const {return value();}
 
-  /** For back compatibility only
-   \deprecated Replaced by set() */
-  void check() {flags |= FL_MENU_VALUE;}
+  /** Back compatibility only.
+    \deprecated
+      Please use Fl_Menu_Item::set() instead.
+      This method will be removed in FLTK 1.5.0 or later.
+    \see set()
+  */
+  inline void check() {set();}
 
-  /** For back compatibility only
-   \deprecated Replaced by clear() */
-  void uncheck() {flags &= ~FL_MENU_VALUE;}
+  /** Back compatibility only.
+    \deprecated
+      Please use Fl_Menu_Item::clear() instead.
+      This method will be removed in FLTK 1.5.0 or later.
+    \see clear()
+  */
+  inline void uncheck() {clear();}
 
   int insert(int,const char*,int,Fl_Callback*,void* =0, int =0);
   int add(const char*, int shortcut, Fl_Callback*, void* =0, int = 0);
diff --git src/Fl_Image_Surface.cxx src/Fl_Image_Surface.cxx
index 6dcb3ba..dc4c7f7 100644
--- src/Fl_Image_Surface.cxx
+++ src/Fl_Image_Surface.cxx
@@ -92,7 +92,7 @@ int Fl_Image_Surface_Driver::printable_rect(int *w, int *h) {
  */
 
 /** Returns a depth 3 image made of all drawings sent to the Fl_Image_Surface object.
- 
+
  The returned object contains its own copy of the RGB data.
  The caller is responsible for deleting the image.
  */
Direct Link to Message ]
 
     
Previous Message ]Next Message ]
 
 

Comments are owned by the poster. All other content is copyright 1998-2024 by Bill Spitzak and others. This project is hosted by The FLTK Team. Please report site problems to 'erco@seriss.com'.