diff options
| author | Albrecht Schlosser <albrechts.fltk@online.de> | 2020-01-08 18:41:50 +0100 |
|---|---|---|
| committer | Albrecht Schlosser <albrechts.fltk@online.de> | 2020-01-08 18:41:50 +0100 |
| commit | 3f1f8715853cd855aa66062f50843b21071f288a (patch) | |
| tree | e8e4fa57ae7fdceb4b0704cde07590a42f1c69fb /documentation/src/migration_1_3.dox | |
| parent | 4197c2616d24b74dd1f48fd18a2145a64a689b35 (diff) | |
Drop 1.0 compatibility; document 1.4 migration
The FLTK 1.0 compatibility support by defining macro 'FLTK_1_0_COMPAT'
did no longer work since FLTK 1.3.x and nobody complained. Hence we
can safely remove this "feature".
Documentation changes:
- Drop chapter 'Migrating Code from FLTK 1.0 to 1.1'
- Drop chapter 'Migrating Code from FLTK 1.1 to 1.3'
- Add chapter 'Migrating Code from FLTK 1.3 to 1.4'
The removed chapters are still available in FLTK 1.3 docs.
Diffstat (limited to 'documentation/src/migration_1_3.dox')
| -rw-r--r-- | documentation/src/migration_1_3.dox | 80 |
1 files changed, 0 insertions, 80 deletions
diff --git a/documentation/src/migration_1_3.dox b/documentation/src/migration_1_3.dox deleted file mode 100644 index 203e8d09a..000000000 --- a/documentation/src/migration_1_3.dox +++ /dev/null @@ -1,80 +0,0 @@ -/** - - \page migration_1_3 Migrating Code from FLTK 1.1 to 1.3 - -This appendix describes the differences between the FLTK -1.1.x and FLTK 1.3.x functions and classes. - -\section migration_1_3_fltk_1_0 Migrating From FLTK 1.0 - -If you want to migrate your code from FLTK 1.0 to FLTK 1.3, -then you should first consult Appendix \ref migration_1_1. - - -\section migration_1_3_fl_scroll Fl_Scroll Widget - -Fl_Scroll::scroll_to(int x, int y) replaces Fl_Scroll::position(int x, int y). - -This change was needed because Fl_Scroll::position(int,int) redefined -Fl_Widget::position(int,int), but with a completely different function (moving -the scrollbars instead of moving the widget). - -Please be aware that you need to change your application's code for all -Fl_Scroll-derived widgets, if you used Fl_Scroll::position(int x, int y) -to position <b>the scrollbars</b> (not the widget itself). - -The compiler will not detect any errors, because your calls to -\b position(int x, int y) will be calling Fl_Widget::position(int x, int y). - - -\section migration_1_3_unicode Unicode (UTF-8) - -FLTK 1.3 uses Unicode (UTF-8) encoding internally. If you are only using -characters in the ASCII range (32-127), there is a high probability that -you don't need to modify your code. However, if you use international -characters (128-255), encoded as e.g. Windows codepage 1252, ISO-8859-1, -ISO-8859-15 or any other encoding, then you will need to update your character -string constants and widget input data accordingly. - -Please refer to the \ref unicode chapter for more details. - -\note It is important that, although your software uses only ASCII characters -for input to FLTK widgets, the user may enter non-ASCII characters, and FLTK -will return these characters with UTF-8 encoding to your application, e.g. -via Fl_Input::value(). You \b will need to re-encode them to \b your (non-UTF-8) -encoding, otherwise you might see or print garbage in your data. - - -\section migration_1_3_int_coords Widget Coordinate Representation - -FLTK 1.3 changed all Widget coordinate variables and methods, e.g. -Fl_Widget::x(), Fl_Widget::y(), Fl_Widget::w(), Fl_Widget::h(), from -short (16-bit) to int (32-bit) representation. This should not affect -any existing code, but makes it possible to use bigger scroll areas -(e.g. Fl_Scroll widget). - - -\htmlonly -<hr> -<table summary="navigation bar" width="100%" border="0"> -<tr> - <td width="45%" align="LEFT"> - <a class="el" href="migration_1_1.html"> - [Prev] - Migrating Code from FLTK 1.0 to 1.1 - </a> - </td> - <td width="10%" align="CENTER"> - <a class="el" href="index.html">[Index]</a> - </td> - <td width="45%" align="RIGHT"> - <a class="el" href="development.html"> - Developer Information - [Next] - </a> - </td> -</tr> -</table> -\endhtmlonly - -*/ |
