+ const char *fn(Fl_Widget *w, const char *uri); ++ +
The link function can be used to retrieve remote or virtual + documents, returning a temporary file that contains the actual + data. If the link function returns NULL, the value of + the Fl_Help_View widget will remain unchanged.
+ +If the link callback cannot handle the URI scheme, it should + return the uri value unchanged or set the value() of the widget + before returning NULL. + */ void link(Fl_Help_Func *fn) { link_ = fn; } int load(const char *f); void resize(int,int,int,int); + /** Gets the size of the Help view */ int size() const { return (size_); } void size(int W, int H) { Fl_Widget::size(W, H); } + /** Sets the default text color. */ void textcolor(Fl_Color c) { if (textcolor_ == defcolor_) textcolor_ = c; defcolor_ = c; } + /** Returns the current default text color. */ Fl_Color textcolor() const { return (defcolor_); } + /** Sets the default text font. */ void textfont(Fl_Font f) { textfont_ = f; format(); } + /** Returns the current default text font. */ Fl_Font textfont() const { return (textfont_); } + /** Sets the default text size. */ void textsize(Fl_Fontsize s) { textsize_ = s; format(); } + /** Gets the default text size. */ Fl_Fontsize textsize() const { return (textsize_); } + /** Returns the current document title, or NULL if there is no title. */ const char *title() { return (title_); } void topline(const char *n); void topline(int); + /** Returns the current top line in pixels. */ int topline() const { return (topline_); } void leftline(int); + /** Gets the left position. */ int leftline() const { return (leftline_); } void value(const char *v); + /** Returns the current buffer contents. */ const char *value() const { return (value_); } void clear_selection(); void select_all(); diff --git a/FL/Fl_Light_Button.H b/FL/Fl_Light_Button.H index b9da5b440..41471b681 100644 --- a/FL/Fl_Light_Button.H +++ b/FL/Fl_Light_Button.H @@ -30,6 +30,16 @@ #include "Fl_Button.H" +/** +
This subclass displays the "on" state by turning on a light, + rather than drawing pushed in. The shape of the "light" + is initially set to FL_DOWN_BOX. The color of the light when + on is controlled with selection_color(), which defaults to FL_YELLOW. + + Buttons generate callbacks when they are clicked by the user. You + control exactly when and how by changing the values for type() and when(). +
\image html Fl_Light_Button.gif
+*/ class FL_EXPORT Fl_Light_Button : public Fl_Button { protected: virtual void draw(); diff --git a/FL/Fl_Preferences.H b/FL/Fl_Preferences.H index 292d5a18a..3eb3a95e6 100644 --- a/FL/Fl_Preferences.H +++ b/FL/Fl_Preferences.H @@ -26,7 +26,7 @@ // /** \file - * Preferences definitions for the Fast Light Tool Kit (FLTK). + Preferences definitions for the Fast Light Tool Kit (FLTK). */ #ifndef Fl_Preferences_H @@ -41,29 +41,29 @@ /** - * Fl_Preferences provides methods to store user - * settings between application starts. It is similar to the - * Registry on WIN32 and Preferences on MacOS, and provides a - * simple configuration mechanism for UNIX. - * - * Fl_Preferences uses a hierarchy to store data. It - * bundles similar data into groups and manages entries into those - * groups as name/value pairs. - * - * Preferences are stored in text files that can be edited - * manually. The file format is easy to read and relatively - * forgiving. Preferences files are the same on all platforms. User - * comments in preference files are preserved. Filenames are unique - * for each application by using a vendor/application naming - * scheme. The user must provide default values for all entries to - * ensure proper operation should preferences be corrupted or not - * yet exist. - * - * Entries can be of any length. However, the size of each - * preferences file should be kept under 100k for performance - * reasons. One application can have multiple preferences files. - * Extensive binary data however should be stored in separate - * files; see getUserdataPath(). + Fl_Preferences provides methods to store user + settings between application starts. It is similar to the + Registry on WIN32 and Preferences on MacOS, and provides a + simple configuration mechanism for UNIX. + + Fl_Preferences uses a hierarchy to store data. It + bundles similar data into groups and manages entries into those + groups as name/value pairs. + + Preferences are stored in text files that can be edited + manually. The file format is easy to read and relatively + forgiving. Preferences files are the same on all platforms. User + comments in preference files are preserved. Filenames are unique + for each application by using a vendor/application naming + scheme. The user must provide default values for all entries to + ensure proper operation should preferences be corrupted or not + yet exist. + + Entries can be of any length. However, the size of each + preferences file should be kept under 100k for performance + reasons. One application can have multiple preferences files. + Extensive binary data however should be stored in separate + files; see getUserdataPath(). */ class FL_EXPORT Fl_Preferences { @@ -71,7 +71,7 @@ class FL_EXPORT Fl_Preferences public: /** - * Define the scope of the preferences. + Define the scope of the preferences. */ enum Root { SYSTEM=0, ///< Preferences are used system-wide @@ -80,345 +80,345 @@ public: // enum Type { win32, macos, fltk }; /** - * The constructor creates a group that manages name/value pairs and - * child groups. Groups are ready for reading and writing at any time. - * The root argument is either Fl_Preferences::USER - * or Fl_Preferences::SYSTEM. - * - * This constructor creates the base instance for all - * following entries and reads existing databases into memory. The - * vendor argument is a unique text string identifying the - * development team or vendor of an application. A domain name or - * an EMail address are great unique names, e.g. - * "researchATmatthiasm.com" or "fltk.org". The - * application argument can be the working title or final - * name of your application. Both vendor and - * application must be valid relative UNIX pathnames and - * may contain '/'s to create deeper file structures. - * - * \param[in] root can be USER or SYSTEM for user specific or system wide preferences - * \param[in] vendor unique text describing the company or author of this file - * \param[in] application unique text describing the application + The constructor creates a group that manages name/value pairs and + child groups. Groups are ready for reading and writing at any time. + The root argument is either Fl_Preferences::USER + or Fl_Preferences::SYSTEM. + + This constructor creates the base instance for all + following entries and reads existing databases into memory. The + vendor argument is a unique text string identifying the + development team or vendor of an application. A domain name or + an EMail address are great unique names, e.g. + "researchATmatthiasm.com" or "fltk.org". The + application argument can be the working title or final + name of your application. Both vendor and + application must be valid relative UNIX pathnames and + may contain '/'s to create deeper file structures. + + \param[in] root can be USER or SYSTEM for user specific or system wide preferences + \param[in] vendor unique text describing the company or author of this file + \param[in] application unique text describing the application */ Fl_Preferences( Root root, const char *vendor, const char *application ); /** - * This constructor is used to create or read a preferences file at an - * arbitrary position in the file system. The file name is generated - * as path/application.prefs. If application - * is 0, path must contain the full file name. - * - * \param[in] path path to the directory that contains the preferences file - * \param[in] vendor unique text describing the company or author of this file - * \param[in] application unique text describing the application + This constructor is used to create or read a preferences file at an + arbitrary position in the file system. The file name is generated + as path/application.prefs. If application + is 0, path must contain the full file name. + + \param[in] path path to the directory that contains the preferences file + \param[in] vendor unique text describing the company or author of this file + \param[in] application unique text describing the application */ Fl_Preferences( const char *path, const char *vendor, const char *application ); /** - * This constructor generates a new group of preference entries - * inside the group or file parent. The group argument - * identifies a group of entries. It can contain '/'s to get quick - * access to individual elements inside the hierarchy. - * - * \param[in] parent reference object for the new group - * \param[in] group name of the group to access (may contain '/'s) + This constructor generates a new group of preference entries + inside the group or file parent. The group argument + identifies a group of entries. It can contain '/'s to get quick + access to individual elements inside the hierarchy. + + \param[in] parent reference object for the new group + \param[in] group name of the group to access (may contain '/'s) */ Fl_Preferences( Fl_Preferences &parent, const char *group ); /** - * \see Fl_Preferences( Fl_Preferences&, const char *group ) + \see Fl_Preferences( Fl_Preferences&, const char *group ) */ Fl_Preferences( Fl_Preferences*, const char *group ); /** - * The destructor removes allocated resources. When used on the - * base preferences group, the destructor flushes all - * changes to the preferences file and deletes all internal - * databases. + The destructor removes allocated resources. When used on the + base preferences group, the destructor flushes all + changes to the preferences file and deletes all internal + databases. */ ~Fl_Preferences(); /** - * Returns the number of groups that are contained within a - * group. - * - * \return 0 for no groups at all + Returns the number of groups that are contained within a + group. + + \return 0 for no groups at all */ int groups(); /** - * Returns the name of the Nth group. There is no guaranteed - * order of group names. The index must be within the range given - * by groups(). - * - * \param[in] index number indexing the requested group - * \return cstring pointer to the group name + Returns the name of the Nth group. There is no guaranteed + order of group names. The index must be within the range given + by groups(). + + \param[in] index number indexing the requested group + \return cstring pointer to the group name */ const char *group( int index ); /** - * Returns non-zero if a group with this name exists. - * Groupnames are relative to the Preferences node and can contain a path. - * "." describes the current node, "./" describes the topmost node. - * By preceding a groupname with a "./", its path becomes relative to the topmost node. - * - * \param[in] group name of group that is searched for - * \return 0 if group was not found + Returns non-zero if a group with this name exists. + Groupnames are relative to the Preferences node and can contain a path. + "." describes the current node, "./" describes the topmost node. + By preceding a groupname with a "./", its path becomes relative to the topmost node. + + \param[in] group name of group that is searched for + \return 0 if group was not found */ char groupExists( const char *group ); /** - * Deletes a group. - * - * \param[in] group name of the group to delete - * \return 0 if call failed + Deletes a group. + + \param[in] group name of the group to delete + \return 0 if call failed */ char deleteGroup( const char *group ); /** - * Returns the number of entries (name/value pairs) in a group. - * - * \return number of entries + Returns the number of entries (name/value pairs) in a group. + + \return number of entries */ int entries(); /** - * Returns the name of an entry. There is no guaranteed order of - * entry names. The index must be within the range given by - * entries(). - * - * \param[in] index number indexing the requested entry - * \return pointer to value cstring + Returns the name of an entry. There is no guaranteed order of + entry names. The index must be within the range given by + entries(). + + \param[in] index number indexing the requested entry + \return pointer to value cstring */ const char *entry( int index ); /** - * Returns non-zero if an entry with this name exists. - * - * \param[in] entry name of entry that is searched for - * \return 0 if entry was not found + Returns non-zero if an entry with this name exists. + + \param[in] entry name of entry that is searched for + \return 0 if entry was not found */ char entryExists( const char *entry ); /** - * Removes a single entry (name/value pair). - * - * \param[in] entry name of entry to delete - * \return 0 if deleting the entry failed + Removes a single entry (name/value pair). + + \param[in] entry name of entry to delete + \return 0 if deleting the entry failed */ char deleteEntry( const char *entry ); /** - * Sets an entry (name/value pair). The return value indicates if there - * was a problem storing the data in memory. However it does not - * reflect if the value was actually stored in the preferences - * file. - * - * \param[in] entry name of entry - * \param[in] value set this entry to \a value - * \return 0 if setting the value failed + Sets an entry (name/value pair). The return value indicates if there + was a problem storing the data in memory. However it does not + reflect if the value was actually stored in the preferences + file. + + \param[in] entry name of entry + \param[in] value set this entry to \a value + \return 0 if setting the value failed */ char set( const char *entry, int value ); /** - * Sets an entry (name/value pair). The return value indicates if there - * was a problem storing the data in memory. However it does not - * reflect if the value was actually stored in the preferences - * file. - * - * \param[in] entry name of entry - * \param[in] value set this entry to \a value - * \return 0 if setting the value failed + Sets an entry (name/value pair). The return value indicates if there + was a problem storing the data in memory. However it does not + reflect if the value was actually stored in the preferences + file. + + \param[in] entry name of entry + \param[in] value set this entry to \a value + \return 0 if setting the value failed */ char set( const char *entry, float value ); /** - * Sets an entry (name/value pair). The return value indicates if there - * was a problem storing the data in memory. However it does not - * reflect if the value was actually stored in the preferences - * file. - * - * \param[in] entry name of entry - * \param[in] value set this entry to \a value - * \param[in] precision number of decimal digits to represent value - * \return 0 if setting the value failed + Sets an entry (name/value pair). The return value indicates if there + was a problem storing the data in memory. However it does not + reflect if the value was actually stored in the preferences + file. + + \param[in] entry name of entry + \param[in] value set this entry to \a value + \param[in] precision number of decimal digits to represent value + \return 0 if setting the value failed */ char set( const char *entry, float value, int precision ); /** - * Sets an entry (name/value pair). The return value indicates if there - * was a problem storing the data in memory. However it does not - * reflect if the value was actually stored in the preferences - * file. - * - * \param[in] entry name of entry - * \param[in] value set this entry to \a value - * \return 0 if setting the value failed + Sets an entry (name/value pair). The return value indicates if there + was a problem storing the data in memory. However it does not + reflect if the value was actually stored in the preferences + file. + + \param[in] entry name of entry + \param[in] value set this entry to \a value + \return 0 if setting the value failed */ char set( const char *entry, double value ); /** - * Sets an entry (name/value pair). The return value indicates if there - * was a problem storing the data in memory. However it does not - * reflect if the value was actually stored in the preferences - * file. - * - * \param[in] entry name of entry - * \param[in] value set this entry to \a value - * \param[in] precision number of decimal digits to represent value - * \return 0 if setting the value failed + Sets an entry (name/value pair). The return value indicates if there + was a problem storing the data in memory. However it does not + reflect if the value was actually stored in the preferences + file. + + \param[in] entry name of entry + \param[in] value set this entry to \a value + \param[in] precision number of decimal digits to represent value + \return 0 if setting the value failed */ char set( const char *entry, double value, int precision ); /** - * Sets an entry (name/value pair). The return value indicates if there - * was a problem storing the data in memory. However it does not - * reflect if the value was actually stored in the preferences - * file. - * - * \param[in] entry name of entry - * \param[in] value set this entry to \a value - * \return 0 if setting the value failed + Sets an entry (name/value pair). The return value indicates if there + was a problem storing the data in memory. However it does not + reflect if the value was actually stored in the preferences + file. + + \param[in] entry name of entry + \param[in] value set this entry to \a value + \return 0 if setting the value failed */ char set( const char *entry, const char *value ); /** - * Sets an entry (name/value pair). The return value indicates if there - * was a problem storing the data in memory. However it does not - * reflect if the value was actually stored in the preferences - * file. - * - * \param[in] entry name of entry - * \param[in] value set this entry to \a value - * \param[in] size of data array - * \return 0 if setting the value failed + Sets an entry (name/value pair). The return value indicates if there + was a problem storing the data in memory. However it does not + reflect if the value was actually stored in the preferences + file. + + \param[in] entry name of entry + \param[in] value set this entry to \a value + \param[in] size of data array + \return 0 if setting the value failed */ char set( const char *entry, const void *value, int size ); /** - * Reads an entry from the group. A default value must be - * supplied. The return value indicates if the value was available - * (non-zero) or the default was used (0). - * - * \param[in] entry name of entry - * \param[out] value returned from preferences or default value if none was set - * \param[in] defaultValue default value to be used if no preference was set - * \return 0 if the default value was used + Reads an entry from the group. A default value must be + supplied. The return value indicates if the value was available + (non-zero) or the default was used (0). + + \param[in] entry name of entry + \param[out] value returned from preferences or default value if none was set + \param[in] defaultValue default value to be used if no preference was set + \return 0 if the default value was used */ char get( const char *entry, int &value, int defaultValue ); /** - * Reads an entry from the group. A default value must be - * supplied. The return value indicates if the value was available - * (non-zero) or the default was used (0). - * - * \param[in] entry name of entry - * \param[out] value returned from preferences or default value if none was set - * \param[in] defaultValue default value to be used if no preference was set - * \return 0 if the default value was used + Reads an entry from the group. A default value must be + supplied. The return value indicates if the value was available + (non-zero) or the default was used (0). + + \param[in] entry name of entry + \param[out] value returned from preferences or default value if none was set + \param[in] defaultValue default value to be used if no preference was set + \return 0 if the default value was used */ char get( const char *entry, float &value, float defaultValue ); /** - * Reads an entry from the group. A default value must be - * supplied. The return value indicates if the value was available - * (non-zero) or the default was used (0). - * - * \param[in] entry name of entry - * \param[out] value returned from preferences or default value if none was set - * \param[in] defaultValue default value to be used if no preference was set - * \return 0 if the default value was used + Reads an entry from the group. A default value must be + supplied. The return value indicates if the value was available + (non-zero) or the default was used (0). + + \param[in] entry name of entry + \param[out] value returned from preferences or default value if none was set + \param[in] defaultValue default value to be used if no preference was set + \return 0 if the default value was used */ char get( const char *entry, double &value, double defaultValue ); /** - * Reads an entry from the group. A default value must be - * supplied. The return value indicates if the value was available - * (non-zero) or the default was used (0). get() allocates memory of - * sufficient size to hold the value. The buffer must be free'd by - * the developer using 'free(value)'. - * - * \param[in] entry name of entry - * \param[out] value returned from preferences or default value if none was set - * \param[in] defaultValue default value to be used if no preference was set - * \return 0 if the default value was used + Reads an entry from the group. A default value must be + supplied. The return value indicates if the value was available + (non-zero) or the default was used (0). get() allocates memory of + sufficient size to hold the value. The buffer must be free'd by + the developer using 'free(value)'. + + \param[in] entry name of entry + \param[out] value returned from preferences or default value if none was set + \param[in] defaultValue default value to be used if no preference was set + \return 0 if the default value was used */ char get( const char *entry, char *&value, const char *defaultValue ); /** - * Reads an entry from the group. A default value must be - * supplied. The return value indicates if the value was available - * (non-zero) or the default was used (0). - * 'maxSize' is the maximum length of text that will be read. - * The text buffer must allow for one additional byte for a trailling zero. - * - * \param[in] entry name of entry - * \param[out] value returned from preferences or default value if none was set - * \param[in] defaultValue default value to be used if no preference was set - * \param[in] maxSize maximum length of value plus one byte for a trailing zero - * \return 0 if the default value was used + Reads an entry from the group. A default value must be + supplied. The return value indicates if the value was available + (non-zero) or the default was used (0). + 'maxSize' is the maximum length of text that will be read. + The text buffer must allow for one additional byte for a trailling zero. + + \param[in] entry name of entry + \param[out] value returned from preferences or default value if none was set + \param[in] defaultValue default value to be used if no preference was set + \param[in] maxSize maximum length of value plus one byte for a trailing zero + \return 0 if the default value was used */ char get( const char *entry, char *value, const char *defaultValue, int maxSize ); /** - * Reads an entry from the group. A default value must be - * supplied. The return value indicates if the value was available - * (non-zero) or the default was used (0). get() allocates memory of - * sufficient size to hold the value. The buffer must be free'd by - * the developer using 'free(value)'. - * - * \param[in] entry name of entry - * \param[out] value returned from preferences or default value if none was set - * \param[in] defaultValue default value to be used if no preference was set - * \param[in] defaultSize size of default value array - * \return 0 if the default value was used + Reads an entry from the group. A default value must be + supplied. The return value indicates if the value was available + (non-zero) or the default was used (0). get() allocates memory of + sufficient size to hold the value. The buffer must be free'd by + the developer using 'free(value)'. + + \param[in] entry name of entry + \param[out] value returned from preferences or default value if none was set + \param[in] defaultValue default value to be used if no preference was set + \param[in] defaultSize size of default value array + \return 0 if the default value was used */ char get( const char *entry, void *&value, const void *defaultValue, int defaultSize ); /** - * Reads an entry from the group. A default value must be - * supplied. The return value indicates if the value was available - * (non-zero) or the default was used (0). - * 'maxSize' is the maximum length of text that will be read. - * - * \param[in] entry name of entry - * \param[out] value returned from preferences or default value if none was set - * \param[in] defaultValue default value to be used if no preference was set - * \param[in] defaultSize size of default value array - * \param[in] maxSize maximum length of value - * \return 0 if the default value was used - * - * \todo maxSize should receive the number of bytes that were read. + Reads an entry from the group. A default value must be + supplied. The return value indicates if the value was available + (non-zero) or the default was used (0). + 'maxSize' is the maximum length of text that will be read. + + \param[in] entry name of entry + \param[out] value returned from preferences or default value if none was set + \param[in] defaultValue default value to be used if no preference was set + \param[in] defaultSize size of default value array + \param[in] maxSize maximum length of value + \return 0 if the default value was used + + \todo maxSize should receive the number of bytes that were read. */ char get( const char *entry, void *value, const void *defaultValue, int defaultSize, int maxSize ); /** - * Returns the size of the value part of an entry. - * - * \return size of value + Returns the size of the value part of an entry. + + \return size of value */ int size( const char *entry ); /** - * Creates a path that is related to the preferences file and - * that is usable for application data beyond what is covered by - * Fl_Preferences. - * - * \param[out] path buffer for user data path - * \param[in] pathlen size of path buffer - * \return 0 if path was not created or pathname can't fit into buffer + Creates a path that is related to the preferences file and + that is usable for application data beyond what is covered by + Fl_Preferences. + + \param[out] path buffer for user data path + \param[in] pathlen size of path buffer + \return 0 if path was not created or pathname can't fit into buffer */ char getUserdataPath( char *path, int pathlen ); /** - * Write all preferences to disk. This function works only with - * the base preference group. This function is rarely used as - * deleting the base preferences flushes automatically. + Write all preferences to disk. This function works only with + the base preference group. This function is rarely used as + deleting the base preferences flushes automatically. */ void flush(); @@ -426,15 +426,15 @@ public: // char import( const char *filename ); /** - * 'Name' provides a simple method to create numerical or more complex - * procedural names for entries and groups on the fly. - * - * Example: prefs.set(Fl_Preferences::Name("File%d",i),file[i]);. - * - * See test/preferences.cxx as a sample for writing arrays into preferences.- * 'Name' is actually implemented as a class inside Fl_Preferences. It casts - * into const char* and gets automatically destroyed after the enclosing call - * ends. + 'Name' provides a simple method to create numerical or more complex + procedural names for entries and groups on the fly. + + Example: prefs.set(Fl_Preferences::Name("File%d",i),file[i]);. + + See test/preferences.cxx as a sample for writing arrays into preferences.
+ 'Name' is actually implemented as a class inside Fl_Preferences. It casts + into const char* and gets automatically destroyed after the enclosing call + ends. */ class FL_EXPORT Name { @@ -443,18 +443,18 @@ public: public: /** - * Create a numerical name. + Create a numerical name. */ Name( unsigned int n ); /** - * Create a name using 'printf' style formatting. + Create a name using 'printf' style formatting. */ Name( const char *format, ... ); /** - * Return the Name as a c-string. - * \internal + Return the Name as a c-string. + \internal */ operator const char *() { return data_; } ~Name(); diff --git a/documentation/todo_filelist_doc.txt b/documentation/todo_filelist_doc.txt index aac1ac06f..e96f7ab12 100644 --- a/documentation/todo_filelist_doc.txt +++ b/documentation/todo_filelist_doc.txt @@ -14,7 +14,7 @@ In Progress Work List (add your WP and name here): - WP3 (engelsman) - WP4 (Fabien) DONE - WP5 (Fabien) DONE - - WP6 (Fabien) + - WP6 (Fabien) DONE - WP7 - WP8 - WP9 @@ -156,10 +156,6 @@ widgets.html Enumerations.H (Albrecht) work in progress ! Fl_Adjuster.H Fl_Adjuster.cxx -Fl_BMP_Image.H -Fl_BMP_Image.cxx -Fl_Bitmap.H -Fl_Bitmap.cxx Fl_Box.H Fl_Box.cxx Fl_Button.H @@ -185,31 +181,18 @@ Fl_Float_Input.H Fl_Font.H Fl_FormsBitmap.H Fl_FormsPixmap.H -Fl_GIF_Image.H -Fl_GIF_Image.cxx Fl_Gl_Choice.H Fl_Gl_Choice.cxx -Fl_Help_Dialog.H -Fl_Help_Dialog.cxx -Fl_Help_View.H -Fl_Help_View.cxx -Fl_Hold_Browser.H Fl_Hor_Fill_Slider.H Fl_Hor_Nice_Slider.H Fl_Hor_Slider.H Fl_Hor_Value_Slider.H -Fl_Image.H -Fl_Image.cxx Fl_Input.H Fl_Input.cxx Fl_Input_.H Fl_Input_.cxx Fl_Input_Choice.H Fl_Int_Input.H -Fl_JPEG_Image.H -Fl_JPEG_Image.cxx -Fl_Light_Button.H -Fl_Light_Button.cxx Fl_Line_Dial.H Fl_Menu.H Fl_Menu.cxx @@ -232,17 +215,8 @@ Fl_Multiline_Output.H Fl_Nice_Slider.H Fl_Object.H Fl_Output.H -Fl_PNG_Image.H -Fl_PNG_Image.cxx -Fl_PNM_Image.H -Fl_PNM_Image.cxx -Fl_Pixmap.H -Fl_Pixmap.cxx -Fl_Preferences.H -Fl_Preferences.cxx Fl_Progress.H Fl_Progress.cxx -Fl_RGB_Image.H Fl_Radio_Button.H Fl_Radio_Light_Button.H Fl_Radio_Round_Button.H @@ -261,8 +235,6 @@ Fl_Scrollbar.H Fl_Scrollbar.cxx Fl_Secret_Input.H Fl_Select_Browser.H -Fl_Shared_Image.H -Fl_Shared_Image.cxx Fl_Simple_Counter.H Fl_Slider.H Fl_Slider.cxx @@ -298,11 +270,7 @@ Fl_Window_hotspot.cxx Fl_Window_iconize.cxx Fl_Wizard.H Fl_Wizard.cxx -Fl_XBM_Image.H -Fl_XBM_Image.cxx Fl_XColor.H -Fl_XPM_Image.H -Fl_XPM_Image.cxx Fl_abort.cxx Fl_get_key.cxx Fl_get_key_mac.cxx diff --git a/src/Fl_Help_Dialog_Dox.cxx b/src/Fl_Help_Dialog_Dox.cxx new file mode 100644 index 000000000..e7f753434 --- /dev/null +++ b/src/Fl_Help_Dialog_Dox.cxx @@ -0,0 +1,119 @@ +// +// "$Id" +// +// Fl_Help_Dialog dialog for the Fast Light Tool Kit (FLTK). +// +// Copyright 1998-2005 by Bill Spitzak and others. +// +// This library is free software; you can redistribute it and/or +// modify it under the terms of the GNU Library General Public +// License as published by the Free Software Foundation; either +// version 2 of the License, or (at your option) any later version. +// +// This library is distributed in the hope that it will be useful, +// but WITHOUT ANY WARRANTY; without even the implied warranty of +// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +// Library General Public License for more details. +// +// You should have received a copy of the GNU Library General Public +// License along with this library; if not, write to the Free Software +// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 +// USA. +// +// Please report all bugs and problems on the following page: +// +// http://www.fltk.org/str.php +// + +// Fl_Help_Dialog (autogenerated class) doxygen documentation placeholder + +/** \class Fl_Help_Dialog + The Fl_Help_Dialog widget displays a standard help dialog window + using the Fl_Help_View widget. + +
The destructor deletes the check button. +*/ Fl_Light_Button::Fl_Light_Button(int X, int Y, int W, int H, const char* l) : Fl_Button(X, Y, W, H, l) { type(FL_TOGGLE_BUTTON); diff --git a/src/Fl_Preferences.cxx b/src/Fl_Preferences.cxx index fbe714e58..28b6950a4 100644 --- a/src/Fl_Preferences.cxx +++ b/src/Fl_Preferences.cxx @@ -212,9 +212,7 @@ char Fl_Preferences::deleteEntry( const char *key ) } -/** - * read an entry from the group - */ + char Fl_Preferences::get( const char *key, int &value, int defaultValue ) { const char *v = node->get( key ); @@ -223,9 +221,7 @@ char Fl_Preferences::get( const char *key, int &value, int defaultValue ) } -/** - * set an entry (name/value pair) - */ + char Fl_Preferences::set( const char *key, int value ) { sprintf( nameBuffer, "%d", value ); @@ -234,9 +230,7 @@ char Fl_Preferences::set( const char *key, int value ) } -/** - * read an entry from the group - */ + char Fl_Preferences::get( const char *key, float &value, float defaultValue ) { const char *v = node->get( key ); @@ -245,9 +239,7 @@ char Fl_Preferences::get( const char *key, float &value, float defaultValue ) } -/** - * set an entry (name/value pair) - */ + char Fl_Preferences::set( const char *key, float value ) { sprintf( nameBuffer, "%g", value ); @@ -256,9 +248,7 @@ char Fl_Preferences::set( const char *key, float value ) } -/** - * set an entry (name/value pair) - */ + char Fl_Preferences::set( const char *key, float value, int precision ) { sprintf( nameBuffer, "%.*g", precision, value ); @@ -267,9 +257,7 @@ char Fl_Preferences::set( const char *key, float value, int precision ) } -/** - * read an entry from the group - */ + char Fl_Preferences::get( const char *key, double &value, double defaultValue ) { const char *v = node->get( key ); @@ -278,9 +266,7 @@ char Fl_Preferences::get( const char *key, double &value, double defaultValue ) } -/** - * set an entry (name/value pair) - */ + char Fl_Preferences::set( const char *key, double value ) { sprintf( nameBuffer, "%g", value ); @@ -289,9 +275,7 @@ char Fl_Preferences::set( const char *key, double value ) } -/** - * set an entry (name/value pair) - */ + char Fl_Preferences::set( const char *key, double value, int precision ) { sprintf( nameBuffer, "%.*g", precision, value ); @@ -373,9 +357,7 @@ char Fl_Preferences::get( const char *key, char *&text, const char *defaultValue } -/** - * set an entry (name/value pair) - */ + char Fl_Preferences::set( const char *key, const char *text ) { const char *s = text ? text : ""; @@ -474,9 +456,7 @@ char Fl_Preferences::get( const char *key, void *&data, const void *defaultValue } -/** - * set an entry (name/value pair) - */ + char Fl_Preferences::set( const char *key, const void *data, int dsize ) { char *buffer = (char*)malloc( dsize*2+1 ), *d = buffer;;