diff options
Diffstat (limited to 'documentation/src/migration_1_5.dox')
| -rw-r--r-- | documentation/src/migration_1_5.dox | 64 |
1 files changed, 53 insertions, 11 deletions
diff --git a/documentation/src/migration_1_5.dox b/documentation/src/migration_1_5.dox index cbe98919b..107bfe061 100644 --- a/documentation/src/migration_1_5.dox +++ b/documentation/src/migration_1_5.dox @@ -31,8 +31,8 @@ build. If you use "Modern CMake" (basically CMake in CONFIGURE mode) to build your own projects the appropriate options are inherited from the properties of -the FLTK libraries as well. Otherwise you may need to set the compiler flags -to use at least C++11 yourself. +the FLTK libraries. Otherwise you may need to set the compiler flags to use +at least C++11 yourself. \section migration_1_5_forms Default for FORMS compatibility is now OFF @@ -61,20 +61,62 @@ FLTK requires C++11 anyway. For more details please see \ref migration_1_4_fl_override. -\section migration_1_5_deprecated Deprecated methods and functions removed +\section migration_1_5_removed Removed Methods and Functions Methods, functions, and global symbols that have been deprecated in FLTK 1.3 -or earlier have been removed. If you need help with those functions because -your old code still uses one or more of them, please consult the FLTK 1.3 or -1.4 documentation for how to replace them with newer functions/methods. +or earlier have been removed in FLTK 1.5.0. -The following (very likely incomplete) list may help to identify such removed -methods and functions: +If you need help with these functions because old code still uses them, please +consult the table below for a quick solution. If this doesn't help please read +the FLTK 1.3 or 1.4 documentation to find out how to replace them with newer +functions or methods, for instance https://www.fltk.org/doc-1.4/deprecated.html. -Removed symbol | Replace with ... ---------------------------|------------------------- -Fl::release() | Fl::grab(0) +The following (possibly incomplete) list can help to identify and replace +these removed methods and functions. + +Removed Symbol | Please Replace With ... +----------------------------------------|------------------------- +Fl::release() | Fl::grab(0) +Fl::set_idle(Fl_Old_Idle_Handler cb) | Fl::add_idle(cb [, data]) +fl_ask(const char *fmt,...) | fl_choice() +fl_clip(int, int, int, int) | fl_push_clip(int x, int y, int w, int h) +Fl_Group::focus(Fl_Widget *W) | (Fl_Widget*) W->take_focus() +Fl_Menu_Item::check() | Fl_Menu_Item::set() +Fl_Menu_Item::checked() const | int Fl_Menu_Item::value() const +Fl_Menu_Item::uncheck() | Fl_Menu_Item::clear() +Fl_Widget::color2() const | Fl_Widget::selection_color() const +Fl_Widget::color2(unsigned) | Fl_Widget::selection_color(unsigned) + + + +\section migration_1_5_deprecated More Deprecated Methods and Functions + +All methods deprecated in <b> FLTK 1.4.x or earlier </b> are likely to be +removed in the next minor FLTK version, presumably 1.6.0. + +Please update your code! + +The following list is currently incomplete and will be extended later. + + +Symbol To Be Removed In The Next Minor Release | Please Replace With ... +-------------------------------------------------------|------------------------- +void Fl_Window::icon(const void *ic) | void Fl_Window::icon(const Fl_RGB_Image *icon) +const void *Fl_Window::icon() const | no replacement (was platform specific) + | +Fl_Tree::first_visible() | in 1.3.3 ABI +Fl_Tree::first_visible_item() | ? +Fl_Tree::item_clicked(Fl_Tree_Item *val) | callback_item() +Fl_Tree::item_clicked() | callback_item() +Fl_Tree::last_visible() | last_visible_item() + | +Fl_Tree_Item::Fl_Tree_Item(const Fl_Tree_Prefs &prefs) | Fl_Tree_Item(Fl_Tree*) +Fl_Tree_Item::next_displayed(Fl_Tree_Prefs &prefs) | next_visible() +Fl_Tree_Item::prev_displayed(Fl_Tree_Prefs &prefs) | prev_visible() + +For details please refer to the documentation of FLTK 1.4 at +https://www.fltk.org/doc-1.4/deprecated.html. \htmlonly |