wwWidgets

Current version: 1.0a (10-Jan-2013) – (src) (MinGW) (MSVC) (Qt SDK)

Overview

wwWidgets is a professional set of useful widgets for Qt 4 and Qt 5. It consists of several different widgets that are either enhanced versions of widgets bundled with Qt or completely new ones that implement functionality not available in Qt including custom multipage container widgets that can hold other widgets.

The classes follow all guidelines for building new widgets. Thanks to that they can be used with different widget styles (like Plastique or WindowsXP) and they are easily stylable using Qt style sheets allowing a perfect blend with the rest of your application.

All widgets can be used directly from within Qt Designer thanks to the widget plugin acompaniating the library. The plugin makes it possible to place wwWidgets on forms and edit their properties and contents just like for default widgets – using the property browser and dedicated property editors for complex properties like sets of colors.

wwWidgets are well documented, after installing the package, the reference is available from within Qt Assistant. The documentation looks like the one available for default Qt classes so it integrates well with it – you can browse and search the documentation and all wwWidgets component symbols can be found in the index.

Gallery

Buttons
The QwwRichTextButton widget provides a button that can display rich text.	The QwwColorButton widget provides a button that allows choosing a color either from a predefined list or a custom one.
The QwwNumPad widget provides a numerical keypad.
Input widgets
The QwwColorComboBox widget provides a combobox that allows choosing a color either from a predefined list or a custom one.	The QwwTwoColorIndicator widget provides a widget that allows to choose two colors (foreground and background).
The QwwHueSatPicker widget provides a widget that allows choosing hue and saturation components of a color using a rectangular representation of the HSV color space.	The QwwHueSatRadialPicker widget provides a widget that allows choosing hue and saturation components of a color using a circular representation of the HSV color space.
The QwwTextSpinBox widget provides a spin box that allows choosing one of predefined texts (just like a regular combo box).	The QwwLongSpinBox widget provides a spin box that can handle large numbers (up to ±2⁶³).
The QwwButtonLineEdit widget that extends QLineEdit with a property that allows setting a regular expression constraining the contents and gives a possibility to associate a programmable button representing an one or more actions that can be performed on the widget.	The QwwClearLineEdit widget that provides a line edit with a button that, when clicked, clears the contents of the widget.
The QwwResetLineEdit widget that provides a line edit with a button that allows to reset its contents to the default value.	The QwwFileChooser widget for providing means of choosing a file or directory to open or to save. The widget has an embedded completer to make it easier to find the right path and a button for choosing the path using a file dialog.
The QwwLoginBox widget provides a way to ask user for internet connection details. Fields displayed to the user can be enabled or disabled, so the widget can serve for providing both login information or a proxied and authorized remote network connection.	The QwwRichTextEdit widget that extends QTextEdit and provides it with functionality that allows to input rich text.
Containers
The QwwTaskPanel widget provides a list of collapsible widgets similar to WindowsXP task panel.	The QwwNavigationBar widget provides a list of widgets similar to MS Outlook navigation bar.
The QwwConfigWidget widget provides a list of configuration pages.
Other
The QwwTipWidget widget provides a browsable list of texts.	The QwwListWidget widget provides an extension to QListWidget that makes it possible to manipulate its items using signals and slots.

Buttons

The QwwRichTextButton widget provides a button that can display rich text.

The QwwColorButton widget provides a button that allows choosing a color either from a predefined list or a custom one.

The QwwNumPad widget provides a numerical keypad.

Input widgets

The QwwColorComboBox widget provides a combobox that allows choosing a color either from a predefined list or a custom one.

The QwwTwoColorIndicator widget provides a widget that allows to choose two colors (foreground and background).

The QwwHueSatPicker widget provides a widget that allows choosing hue and saturation components of a color using a rectangular representation of the HSV color space.

The QwwHueSatRadialPicker widget provides a widget that allows choosing hue and saturation components of a color using a circular representation of the HSV color space.

The QwwTextSpinBox widget provides a spin box that allows choosing one of predefined texts (just like a regular combo box).

The QwwLongSpinBox widget provides a spin box that can handle large numbers (up to ±2⁶³).

The QwwButtonLineEdit widget that extends QLineEdit with a property that allows setting a regular expression constraining the contents and gives a possibility to associate a programmable button representing an one or more actions that can be performed on the widget.

The QwwClearLineEdit widget that provides a line edit with a button that, when clicked, clears the contents of the widget.

The QwwResetLineEdit widget that provides a line edit with a button that allows to reset its contents to the default value.

The QwwFileChooser widget for providing means of choosing a file or directory to open or to save. The widget has an embedded completer to make it easier to find the right path and a button for choosing the path using a file dialog.

The QwwLoginBox widget provides a way to ask user for internet connection details. Fields displayed to the user can be enabled or disabled, so the widget can serve for providing both login information or a proxied and authorized remote network connection.

The QwwRichTextEdit widget that extends QTextEdit and provides it with functionality that allows to input rich text.

Containers

The QwwTaskPanel widget provides a list of collapsible widgets similar to WindowsXP task panel.

The QwwNavigationBar widget provides a list of widgets similar to MS Outlook navigation bar.

The QwwConfigWidget widget provides a list of configuration pages.

Other

The QwwTipWidget widget provides a browsable list of texts.

The QwwListWidget widget provides an extension to QListWidget that makes it possible to manipulate its items using signals and slots.

Download

Installation

Extract the archive to a temporary directory. Either issue a tar zxf wwWidgets-1.0.tar.gz command from within a terminal or use a graphical unpacker like WinZIP or Ark. Then you need to go through the standard qmake && make procedure. Finally issue make install to install the package in your Qt tree. You might need to have superuser priviledges to perform the last step.

Usage

Usage of wwWidgets in your projects is trivial. Once you install the package on your system all you have to do is to add the following line to your project (.pro) file: CONFIG+=wwwidgets Just remember to run qmake afterwards. From now on you can use wwWidgets includes and classes in your project.

#include <QApplication>
#include <QwwRichTextButton>

int main(int argc, char **argv){
  QApplication app(argc, argv);
  QwwRichTextButton b;
  b.setText("<B>Hello</B> <font color='red'>world</font>");
  b.show();
  return app.exec();
}

When distributing the project, remember to deploy the widget library with it along regular Qt libs.

Licensing

wwWidgets is available under dual licence – GPL for Open Source development and Commercial licence for other users. If you want to purchase a commercial licence, please contact me by sending an email to wwwidgets<at>wysota.eu.org.