QtBase
v6.3.1
|
The QStyledItemDelegate class provides display and editing facilities for data items from a model. More...
#include <qstyleditemdelegate.h>
Protected Member Functions | |
virtual void | initStyleOption (QStyleOptionViewItem *option, const QModelIndex &index) const |
bool | eventFilter (QObject *object, QEvent *event) override |
bool | editorEvent (QEvent *event, QAbstractItemModel *model, const QStyleOptionViewItem &option, const QModelIndex &index) override |
Protected Member Functions inherited from QAbstractItemDelegate | |
QAbstractItemDelegate (QObjectPrivate &, QObject *parent=nullptr) | |
Protected Member Functions inherited from QObject | |
QObject * | sender () const |
int | senderSignalIndex () const |
int | receivers (const char *signal) const |
bool | isSignalConnected (const QMetaMethod &signal) const |
virtual void | timerEvent (QTimerEvent *event) |
virtual void | childEvent (QChildEvent *event) |
virtual void | customEvent (QEvent *event) |
virtual void | connectNotify (const QMetaMethod &signal) |
virtual void | disconnectNotify (const QMetaMethod &signal) |
QObject (QObjectPrivate &dd, QObject *parent=nullptr) | |
The QStyledItemDelegate class provides display and editing facilities for data items from a model.
\inmodule QtWidgets
When displaying data from models in Qt item views, e.g., a QTableView, the individual items are drawn by a delegate. Also, when an item is edited, it provides an editor widget, which is placed on top of the item view while editing takes place. QStyledItemDelegate is the default delegate for all Qt item views, and is installed upon them when they are created.
The QStyledItemDelegate class is one of the \l{Model/View Classes} and is part of Qt's \l{Model/View Programming}{model/view framework}. The delegate allows the display and editing of items to be developed independently from the model and view.
The data of items in models are assigned an \l{Qt::}{ItemDataRole}; each item can store a QVariant for each role. QStyledItemDelegate implements display and editing for the most common datatypes expected by users, including booleans, integers, and strings.
The data will be drawn differently depending on which role they have in the model. The following table describes the roles and the data types the delegate can handle for each of them. It is often sufficient to ensure that the model returns appropriate data for each of the roles to determine the appearance of items in views.
\table \header
Editors are created with a QItemEditorFactory; a default static instance provided by QItemEditorFactory is installed on all item delegates. You can set a custom factory using setItemEditorFactory() or set a new default factory with QItemEditorFactory::setDefaultFactory(). It is the data stored in the item model with the \l{Qt::}{EditRole} that is edited. See the QItemEditorFactory class for a more high-level introduction to item editor factories. The \l{Color Editor Factory Example}{Color Editor Factory} example shows how to create custom editors with a factory.
Definition at line 56 of file qstyleditemdelegate.h.
Constructs an item delegate with the given parent.
Definition at line 251 of file qstyleditemdelegate.cpp.
QStyledItemDelegate::~QStyledItemDelegate | ( | ) |
Destroys the item delegate.
Definition at line 259 of file qstyleditemdelegate.cpp.
|
overridevirtual |
Returns the widget used to edit the item specified by index for editing. The parent widget and style option are used to control how the editor widget appears.
Reimplemented from QAbstractItemDelegate.
Reimplemented in ItemDelegate, EditorItemDelegate, and DialogItemDelegate.
Definition at line 440 of file qstyleditemdelegate.cpp.
|
virtual |
This function returns the string that the delegate will use to display the Qt::DisplayRole of the model in locale. value is the value of the Qt::DisplayRole provided by the model.
The default implementation uses the QLocale::toString to convert value into a QString.
This function is not called for empty model indices, i.e., indices for which the model returns an invalid QVariant.
Definition at line 276 of file qstyleditemdelegate.cpp.
|
overrideprotectedvirtual |
\reimp
Reimplemented from QAbstractItemDelegate.
Definition at line 603 of file qstyleditemdelegate.cpp.
Returns true
if the given editor is a valid QWidget and the given event is handled; otherwise returns false
. The following key press events are handled by default:
\list
If the editor's type is QTextEdit or QPlainTextEdit then \uicontrol Enter and \uicontrol Return keys are not handled.
In the case of \uicontrol Tab, \uicontrol Backtab, \uicontrol Enter and \uicontrol Return key press events, the editor's data is committed to the model and the editor is closed. If the event is a \uicontrol Tab key press the view will open an editor on the next item in the view. Likewise, if the event is a \uicontrol Backtab key press the view will open an editor on the previous item in the view.
If the event is a \uicontrol Esc key press event, the editor is closed without committing its data.
Reimplemented from QObject.
Definition at line 594 of file qstyleditemdelegate.cpp.
|
protectedvirtual |
Initialize option with the values using the index index. This method is useful for subclasses when they need a QStyleOptionViewItem, but don't want to fill in all the information themselves.
Reimplemented in QSideBarDelegate.
Definition at line 288 of file qstyleditemdelegate.cpp.
QItemEditorFactory * QStyledItemDelegate::itemEditorFactory | ( | ) | const |
Returns the editor factory used by the item delegate. If no editor factory is set, the function will return null.
Definition at line 544 of file qstyleditemdelegate.cpp.
|
overridevirtual |
Renders the delegate using the given painter and style option for the item specified by index.
This function paints the item using the view's QStyle.
When reimplementing paint in a subclass. Use the initStyleOption() to set up the option in the same way as the QStyledItemDelegate.
Whenever possible, use the option while painting. Especially its \l{QStyleOption::}{rect} variable to decide where to draw and its \l{QStyleOption::}{state} to determine if it is enabled or selected.
After painting, you should ensure that the painter is returned to the state it was supplied in when this function was called. For example, it may be useful to call QPainter::save() before painting and QPainter::restore() afterwards.
Implements QAbstractItemDelegate.
Reimplemented in Delegate12308, QComboBoxDelegate, HoverItemDelegate, and QCompleterItemDelegate.
Definition at line 396 of file qstyleditemdelegate.cpp.
|
overridevirtual |
Sets the data to be displayed and edited by the editor from the data model item specified by the model index.
The default implementation stores the data in the editor widget's \l {Qt's Property System} {user property}.
Reimplemented from QAbstractItemDelegate.
Reimplemented in StateChangeDelegate.
Definition at line 460 of file qstyleditemdelegate.cpp.
void QStyledItemDelegate::setItemEditorFactory | ( | QItemEditorFactory * | factory | ) |
Sets the editor factory to be used by the item delegate to be the factory specified. If no editor factory is set, the item delegate will use the default editor factory.
Definition at line 557 of file qstyleditemdelegate.cpp.
|
overridevirtual |
Gets data from the editor widget and stores it in the specified model at the item index.
The default implementation gets the value to be stored in the data model from the editor widget's \l {Qt's Property System} {user property}.
Reimplemented from QAbstractItemDelegate.
Reimplemented in DialogItemDelegate.
Definition at line 487 of file qstyleditemdelegate.cpp.
|
overridevirtual |
Returns the size needed by the delegate to display the item specified by index, taking into account the style information provided by option.
This function uses the view's QStyle to determine the size of the item.
Implements QAbstractItemDelegate.
Reimplemented in QComboBoxDelegate, TestDelegate, QtTestItemDelegate, and TestDelegate.
Definition at line 419 of file qstyleditemdelegate.cpp.
|
overridevirtual |
Updates the editor for the item specified by index according to the style option given.
Reimplemented from QAbstractItemDelegate.
Definition at line 512 of file qstyleditemdelegate.cpp.