|  | Home · Overviews · Examples

# QItemEditorCreatorBase Class Reference
[com.trolltech.qt.gui module]

The `QItemEditorCreatorBase` class provides an abstract base class that must be subclassed when implementing new item editor creators. More...

## Detailed Description

The `QItemEditorCreatorBase` class provides an abstract base class that must be subclassed when implementing new item editor creators.

`QItemEditorCreatorBase` objects are specialized widget factories that provide editor widgets for one particular `QVariant` data type. They are used by `QItemEditorFactory` to create editors for `QItemDelegate`s. Creator bases must be registered with QItemEditorFactory::registerEditor().

An editor should provide a user property for the data it edits. QItemDelagates can then access the property using Qt's meta-object system to set and retrieve the editing data. A property is set as the user property with the USER keyword:

        Q_PROPERTY(QColor color READ color WRITE setColor USER true)

If the editor does not provide a user property, it must return the name of the property from `valuePropertyName`; delegates will then use the name to access the property. If a user property exists, item delegates will not call `valuePropertyName`.

QStandardItemEditorCreator is a convenience template class that can be used to register widgets without the need to subclass `QItemEditorCreatorBase`.

See also `QStandardItemEditorCreator`, `QItemEditorFactory`, Model/View Programming, and Color Editor Factory Example.