QItemEditorFactory¶
The
QItemEditorFactory
class provides widgets for editing item data in views and delegates. More…
Synopsis¶
Functions¶
def
registerEditor
(userType, creator)
Virtual functions¶
def
createEditor
(userType, parent)def
valuePropertyName
(userType)
Static functions¶
def
defaultFactory
()def
setDefaultFactory
(factory)
Detailed Description¶
When editing data in an item view, editors are created and displayed by a delegate.
QStyledItemDelegate
, 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 of
QItemEditorCreatorBase
instances, which are specialized editors that produce editors for one particularQVariant
data type (All Qt models store their data inQVariant
s).
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.
Type
Editor Widget
bool
double
int
unsigned int
QDate
QDateTime
QPixmap
QString
QTime
Additional editors can be registered with the
registerEditor()
function.
- class PySide2.QtWidgets.QItemEditorFactory¶
Constructs a new item editor factory.
- PySide2.QtWidgets.QItemEditorFactory.createEditor(userType, parent)¶
- Parameters:
userType – int
parent –
PySide2.QtWidgets.QWidget
- Return type:
Creates an editor widget with the given
parent
for the specifieduserType
of data, and returns it as aQWidget
.See also
- static PySide2.QtWidgets.QItemEditorFactory.defaultFactory()¶
- Return type:
Returns the default item editor factory.
See also
- PySide2.QtWidgets.QItemEditorFactory.registerEditor(userType, creator)¶
- Parameters:
userType – int
creator –
PySide2.QtWidgets.QItemEditorCreatorBase
Registers an item editor creator specified by
creator
for the givenuserType
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 also
- static PySide2.QtWidgets.QItemEditorFactory.setDefaultFactory(factory)¶
- Parameters:
factory –
PySide2.QtWidgets.QItemEditorFactory
Sets the default item editor factory to the given
factory
. Both new and existing delegates will use the new factory.See also
- PySide2.QtWidgets.QItemEditorFactory.valuePropertyName(userType)¶
- Parameters:
userType – int
- Return type:
Returns the property name used to access data for the given
userType
of data.
© 2022 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.