Property Browser

A property browser framework enabling the user to edit a set of properties.

The framework provides a browser widget that displays the given properties with labels and corresponding editing widgets (e.g. line edits or comboboxes). The various types of editing widgets are provided by the framework's editor factories: For each property type, the framework provides a property manager (e.g. QtIntPropertyManager and QtStringPropertyManager) which can be associated with the preferred editor factory (e.g. QtSpinBoxFactory and QtLineEditFactory). The framework also provides a variant based property type with corresponding variant manager and factory. Finally, the framework provides three ready-made implementations of the browser widget: QtTreePropertyBrowser, QtButtonPropertyBrowser and QtGroupBoxPropertyBrowser.

Documentation:

Classes:

Examples:

Tested on:

Qt 4.4, 4.5 / Windows XP / MSVC.NET 2008
Qt 4.4, 4.5 / Linux / gcc
Qt 4.4, 4.5 / MacOS X 10.5 / gcc

Unsupported platforms:

Only the tested platforms are supported, however the classes should be platform independent and are likely to work on the platforms supported by Qt.

Download Commercial Edition:

Only available for Qt Solutions license holders with a valid Support and Maintenance agreement (authentication required).

Download Open Source Edition (LGPL):

Changes:

2.5: QtRectPropertyManager and QtRectFPropertyManager - by default constraint is null rect meaning no constraint is applied
2.5: Expand root item with single click on the '+' icon
2.5: Compile with QT_NO_CURSOR
2.5: "Object Controller" example added. It implements a similar widget to the property editor in QDesigner
2.4: Single step attribute added to: QtIntPropertyManager and QtDoublePropertyManager
2.4: New factories providing popup dialogs added: QtColorEditorFactory and QtFontEditorFactory
2.4: QtTreePropertyBrowser - keyboard navigation improved
2.4: QtTreePropertyBrowser - possibility of coloring properties added
2.4: QtTreePropertyBrowser - propertiesWithoutValueMarked and alternatingRowColors features added
2.4: QtTreePropertyBrowser - group items are rendered better
2.4: Fixed memory leak of QtProperty
2.3: New property browser class added - QtButtonPropertyBrowser with drop down button as a grouping element
2.3: Kerning subproperty exposed in Font type
2.3: Support for icons in enum type added
2.3: KeySequence, Char, Locale and Cursor types supported
2.3: QtTreePropertyBrowser - disabling an item closes its editor
2.3: QtProperty - setModified() and isModified() methods added
2.3: Various bugfixes and improvements
2.2: "Decoration" example added - it shows how to add new responsibilities to the existing managers and editor factories
2.2: QtGroupBoxPropertyBrowser - fixed crash in case of deleting the editor factory and then deleting the manager
2.2: QtTreePropertyBrowser - "resizeMode" and "splitterPosition" properties added
2.2: Possibility to control expanded state of QtTreePropertyBrowser's items from code
2.2: QtBrowserItem class introduced, useful for identifying browser's gui elements
2.2: QtProperty - ensure inserted subproperty is different from "this" property
2.2: Proper translation calls for tree property browser
2.2: PointF, SizeF and RectF types supported
2.2: Decimals attribute added to "double" property type
2.2: Removed bug in color icon generation
2.2: FocusOut event now filtered out in case of Qt::ActiveWindowFocusReason reason. In that case editor is not closed when its sub dialog is executed
2.1: QtProperty - hasValue() method added, useful for group properties
2.1: QtTreePropertyBrowser - "rootIsDecorated", "indentation" and "headerVisible" properties added
2.1: QtProperty - setEnabled() and isEnabled() methods added
2.1: QtTreePropertyBrowser and QtGroupBoxPropertyBrowser - internal margin set to 0
2.1: QtAbstractPropertyManager - initializeProperty() and uninitializeProperty() without const modifier now
2.1: QtTreePropertyBrowser - tooltip of property applied to first column, while second column shows the value text of property in its tooltip

Sections