diff options
| author | engelsman <engelsman> | 2008-10-11 12:46:11 +0000 |
|---|---|---|
| committer | engelsman <engelsman> | 2008-10-11 12:46:11 +0000 |
| commit | 9584477b2684aa23db696645d541f2c06cac819d (patch) | |
| tree | f0d81a3717a6712f6387541b68d1af427ec5d5db /documentation/migration_1_1.dox | |
| parent | 7c977f76a0a863483d68dc4d784699b96dede8fa (diff) | |
more html to doxygen conversion for {osissues,migration*,development}.dox
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6410 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
Diffstat (limited to 'documentation/migration_1_1.dox')
| -rw-r--r-- | documentation/migration_1_1.dox | 101 |
1 files changed, 53 insertions, 48 deletions
diff --git a/documentation/migration_1_1.dox b/documentation/migration_1_1.dox index 2f1533675..544532108 100644 --- a/documentation/migration_1_1.dox +++ b/documentation/migration_1_1.dox @@ -2,51 +2,52 @@ \page migration_1_1 G - Migrating Code from FLTK 1.0 to 1.1 -<P>This appendix describes the differences between the FLTK -1.0.x and FLTK 1.1.x functions and classes.</P> -<H2>Color Values</H2> +This appendix describes the differences between the FLTK +1.0.x and FLTK 1.1.x functions and classes. -<P>Color values are now stored in a 32-bit unsigned integer +\section migration_1_1_color Color Values + +Color values are now stored in a 32-bit unsigned integer instead of the unsigned character in 1.0.x. This allows for the specification of 24-bit RGB values or 8-bit FLTK color indices. -<P><TT>FL_BLACK</TT> and <TT>FL_WHITE</TT> now remain black and +<tt>FL_BLACK</tt> and <tt>FL_WHITE</tt> now remain black and white, even if the base color of the gray ramp is changed using -<A HREF="Fl.html#Fl.background"><TT>Fl::background()</TT></A>. -<TT>FL_DARK3</TT> and <TT>FL_LIGHT3</TT> can be used instead to -draw a very dark or a very bright background hue.</P> +<A HREF="Fl.html#Fl.background"><tt>Fl::background()</tt></A>. +<tt>FL_DARK3</tt> and <tt>FL_LIGHT3</tt> can be used instead to +draw a very dark or a very bright background hue. -<P>Widgets use the new color symbols <TT>FL_FORGROUND_COLOR</TT>, -<TT>FL_BACKGROUND_COLOR</TT>, <TT>FL_BACKGROUND2_COLOR</TT>, -<TT>FL_INACTIVE_COLOR</TT>, and <TT>FL_SELECTION_COLOR</TT>. +Widgets use the new color symbols <tt>FL_FORGROUND_COLOR</tt>, +<tt>FL_BACKGROUND_COLOR</tt>, <tt>FL_BACKGROUND2_COLOR</tt>, +<tt>FL_INACTIVE_COLOR</tt>, and <tt>FL_SELECTION_COLOR</tt>. More details can be found in the chapter -<A HREF="enumerations.html#colors">Enumerations</A>.</P> +<A HREF="enumerations.html#colors">Enumerations</A>. -<H2>Cut and Paste Support</H2> +\section migration_1_1_cutnpaste Cut and Paste Support -<P>The FLTK clipboard is now broken into two parts - a local +The FLTK clipboard is now broken into two parts - a local selection value and a cut-and-paste value. This allows FLTK to support things like highlighting and replacing text that was previously cut or copied, which makes FLTK applications behave like traditional GUI applications. -<H2>File Chooser</H2> +\section migration_1_1_file_chooser File Chooser -<P>The file chooser in FLTK 1.1.x is significantly different +The file chooser in FLTK 1.1.x is significantly different than the one supplied with FLTK 1.0.x. Any code that directly -references the old <TT>FCB</TT> class or members will need -to be ported to the new <A -HREF="Fl_File_Chooser.html"><TT>Fl_File_Chooser</TT></A> -class.</P> +references the old <tt>FCB</tt> class or members will need +to be ported to the new +<A HREF="Fl_File_Chooser.html"><tt>Fl_File_Chooser</tt></A> +class. -<H2>Function Names</H2> +\section migration_1_1_functions Function Names -<P>Some function names have changed from FLTK 1.0.x to 1.1.x in +Some function names have changed from FLTK 1.0.x to 1.1.x in order to avoid name space collisions. You can still use the old -function names by defining the <TT>FLTK_1_0_COMPAT</TT> +function names by defining the <tt>FLTK_1_0_COMPAT</tt> symbol on the command-line when you compile -(<TT>-DFLTK_1_0_COMPAT</TT>) or in your source, e.g.: +(<tt>-DFLTK_1_0_COMPAT</tt>) or in your source, e.g.: \code #define FLTK_1_0_COMPAT @@ -55,9 +56,10 @@ symbol on the command-line when you compile #include <FL/filename.H> \endcode -<P>The following table shows the old and new function names:</P> +The following table shows the old and new function names: -<CENTER><TABLE WIDTH="80%" BORDER="1"> +<CENTER> +<TABLE WIDTH="80%" BORDER="1"> <TR> <TH>Old 1.0.x Name</TH> <TH>New 1.1.x Name</TH> @@ -118,37 +120,40 @@ symbol on the command-line when you compile <TD>numericsort()</TD> <TD>fl_numericsort()</TD> </TR> -</TABLE></CENTER> +</TABLE> +</CENTER> -<H2>Image Support</H2> +\section migration_1_1_images Image Support -<P>Image support in FLTK has been significantly revamped in -1.1.x. The <A HREF="Fl_Image.html"><TT>Fl_Image</TT></A> class +Image support in FLTK has been significantly revamped in +1.1.x. The <A HREF="Fl_Image.html"><tt>Fl_Image</tt></A> class is now a proper base class, with the core image drawing -functionality in the <A -HREF="Fl_Bitmap.html"><TT>Fl_Bitmap</TT></A>, <A -HREF="Fl_Pixmap.html"><TT>Fl_Pixmap</TT></A>, and <A -HREF="Fl_RGB_Image.html"><TT>Fl_RGB_Image</TT></A> classes. - -<P>BMP, GIF, JPEG, PNG, XBM, and XPM image files can now be -loaded using the appropriate image classes, and the <A -HREF="Fl_Shared_Image.html"><TT>Fl_Shared_Image</TT></A> class -can be used to cache images in memory. - -<P>Image labels are no longer provided as an add-on label type. -If you use the old <TT>label()</TT> methods on an image, the -widget's <TT>image()</TT> method is called to set the image +functionality in the +<A HREF="Fl_Bitmap.html"><tt>Fl_Bitmap</tt></A>, +<A HREF="Fl_Pixmap.html"><tt>Fl_Pixmap</tt></A>, +and +<A HREF="Fl_RGB_Image.html"><tt>Fl_RGB_Image</tt></A> +classes. + +BMP, GIF, JPEG, PNG, XBM, and XPM image files can now be +loaded using the appropriate image classes, and the +<A HREF="Fl_Shared_Image.html"><tt>Fl_Shared_Image</tt></A> +class can be used to cache images in memory. + +Image labels are no longer provided as an add-on label type. +If you use the old <tt>label()</tt> methods on an image, the +widget's <tt>image()</tt> method is called to set the image as the label. -<P>Image labels in menu items must still use the old labeltype +Image labels in menu items must still use the old labeltype mechanism to preserve source compatibility. -<H2>Keyboard Navigation</H2> +\section migration_1_1_keyboard Keyboard Navigation -<P>FLTK 1.1.x now supports keyboard navigation and control with +FLTK 1.1.x now supports keyboard navigation and control with all widgets. To restore the old FLTK 1.0.x behavior so that only -text widgets get keyboard focus, call the <A -HREF="Fl.html#Fl.visible_focus"><CODE>Fl::visible_focus()</CODE></A> +text widgets get keyboard focus, call the +<A HREF="Fl.html#Fl.visible_focus"><CODE>Fl::visible_focus()</CODE></A> method to disable it: \code |
