Contents

• Public Functions
• Static Public Members
• Detailed Description
• Standard Editing Widgets

Detailed Description

TheQItemEditorFactory class provides widgets for editing item data in views and delegates.

When editing data in an item view, editors are created and displayed by a delegate.QItemDelegate, which is the delegate by default installed on Qt's item views, uses aQItemEditorFactory to create editors for it. A default unique instance provided byQItemEditorFactory is used by all item delegates. If you set a new default factory withsetDefaultFactory(), the new factory will be used by existing and new delegates.

A factory keeps a collection ofQItemEditorCreatorBase instances, which are specialized editors that produce editors for one particularQVariant data type (All Qt models store their data inQVariants).

Standard Editing Widgets

The standard factory implementation provides editors for a variety of data types. These are created whenever a delegate needs to provide an editor for data supplied by a model. The following table shows the relationship between types and the standard editors provided.

Additional editors can be registered with theregisterEditor() function.

Member Function Documentation

QItemEditorFactory::QItemEditorFactory()

Constructs a new item editor factory.

[virtual]QItemEditorFactory::~QItemEditorFactory()

Destroys the item editor factory.

[virtual]QWidget * QItemEditorFactory::createEditor(QVariant::Type type,QWidget * parent) const

Creates an editor widget with the givenparent for the specifiedtype of data, and returns it as aQWidget.

See alsoregisterEditor().

[static]constQItemEditorFactory * QItemEditorFactory::defaultFactory()

Returns the default item editor factory.

See alsosetDefaultFactory().

void QItemEditorFactory::registerEditor(QVariant::Type type,QItemEditorCreatorBase * creator)

Registers an item editor creator specified bycreator for the giventype of data.

Note: The factory takes ownership of the item editor creator and will destroy it if a new creator for the same type is registered later.

See alsocreateEditor().

[static]void QItemEditorFactory::setDefaultFactory(QItemEditorFactory * factory)

Sets the default item editor factory to the givenfactory. Both new and existing delegates will use the new factory.

See alsodefaultFactory().

[virtual]QByteArray QItemEditorFactory::valuePropertyName(QVariant::Type type) const

Returns the property name used to access data for the giventype of data.