readme

c++的guiQt做的开发

MP Widgets
==========

Cross-platform widget and utility library for QT.
QT 4.1 or newer is required.
The library may work with Qt 4.0, but this was not tested.

What's this?
-----------

This library contains some reusable components to help developing a Qt application.
This is third program in which I am using them with very little changes (actually,
most of the changes were because of porting from Qt3 to Qt4), so I decided to
separate the components into a library to ease further reuse - either by myself
or by anyone else interested in provided functionality.

License
-------

The library is licensed under GNU General Public License (GPL) version 2.
See LICENSE.GPL for full text of the license.

Contents
--------

Usually, one .cc and .h file correspond to one class, with few exceptions:
* util.cc and util.h contain some utility functions
* args.cc and args.h contain utility functions helping with commandline arguments handling
* guitypes.h is header defining a few types

Other files contain appropriate classes:

* BoolOption           Widget for use in OptionWindow for editing boolean values using a checkbox
                       (Implementation in booloption.cc, include booloption.h)
* ComboOption          Widget for use in OptionWindow for editing string values using a combobox
                       (Implementation in combooption.cc, include combooption.h)
* DialogOption         Widget for use in OptionWindow for editing string values with helper dialog
                       (Implementation in dialogoption.cc, include dialogoption.h)
* FontOption           Widget for use in OptionWindow for editing font name
                       (Implementation in fontoption.cc, include fontoption.h)
* IconCache            Cache for icons used in application, mainly menus and toolbars
                       (Implementation in iconcache.cc, include iconcache.h)
* Info                 Generic dialog for showing information from key=value maps
                       (Implementation in info.cc, include info.h)
* IntOption            Widget for use in OptionWindow for editing integer values using an editbox
                       (Implementation in intoption.cc, include intoption.h)
* InvalidMenuException Exception thrown when invalid menu or toolbar item is encountered in configuration
                       (Implementation in invalidmenuexception.cc, include invalidmenuexception.h)
* MenuAction           Class representing single menu item
                       (Implementation in menuaction.cc, include menuaction.h)
* MenuTool             Class for managing menu and toolbar items. Can be subclassed to add support for special toolbar items.
                       (Implementation in menutool.cc, include menutool.h)
* Option               Abstract widget for use in OptionWindow for editing single value
                       (Implementation in option.cc, include option.h)
* OptionWindow         Option window. Have to be subclassed and filled with Option widgets on initialization
                       (Implementation in optionwindow.cc, include optionwindow.h)
* RealOption           Widget for use in OptionWindow for editing floating point values using an editbox
                       (Implementation in realoption.cc, include realoption.h)
* Settings             Class for saving and loading user settings
                       (Implementation in settings.cc, include settings.h)
* StaticSettings       Class for reading static read-only settings from resource file
                       (Implementation in staticsettings.cc, include staticsettings.h)
* StringOption         Widget for use in OptionWindow for editing string values using an editbox
                       (Implementation in stringoption.cc, include stringoption.h)
* Toolbar              Toolbar, can be filled with ToolButtons or generic QWidgets
                       (Implementation in toolbar.cc, include toolbar.h)
* ToolButton           Button used on toolbar, with tooltip, shortcut and helptext
                       (Implementation in toolbutton.cc, include toolbutton.h)
                      
API documentation is generated by doxygen and is in subdirectories html and latex