| 1 | /**************************************************************************** | 
|---|
| 2 | ** | 
|---|
| 3 | ** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies). | 
|---|
| 4 | ** Contact: Qt Software Information (qt-info@nokia.com) | 
|---|
| 5 | ** | 
|---|
| 6 | ** This file is part of the QtGui module of the Qt Toolkit. | 
|---|
| 7 | ** | 
|---|
| 8 | ** $QT_BEGIN_LICENSE:LGPL$ | 
|---|
| 9 | ** Commercial Usage | 
|---|
| 10 | ** Licensees holding valid Qt Commercial licenses may use this file in | 
|---|
| 11 | ** accordance with the Qt Commercial License Agreement provided with the | 
|---|
| 12 | ** Software or, alternatively, in accordance with the terms contained in | 
|---|
| 13 | ** a written agreement between you and Nokia. | 
|---|
| 14 | ** | 
|---|
| 15 | ** GNU Lesser General Public License Usage | 
|---|
| 16 | ** Alternatively, this file may be used under the terms of the GNU Lesser | 
|---|
| 17 | ** General Public License version 2.1 as published by the Free Software | 
|---|
| 18 | ** Foundation and appearing in the file LICENSE.LGPL included in the | 
|---|
| 19 | ** packaging of this file.  Please review the following information to | 
|---|
| 20 | ** ensure the GNU Lesser General Public License version 2.1 requirements | 
|---|
| 21 | ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. | 
|---|
| 22 | ** | 
|---|
| 23 | ** In addition, as a special exception, Nokia gives you certain | 
|---|
| 24 | ** additional rights. These rights are described in the Nokia Qt LGPL | 
|---|
| 25 | ** Exception version 1.0, included in the file LGPL_EXCEPTION.txt in this | 
|---|
| 26 | ** package. | 
|---|
| 27 | ** | 
|---|
| 28 | ** GNU General Public License Usage | 
|---|
| 29 | ** Alternatively, this file may be used under the terms of the GNU | 
|---|
| 30 | ** General Public License version 3.0 as published by the Free Software | 
|---|
| 31 | ** Foundation and appearing in the file LICENSE.GPL included in the | 
|---|
| 32 | ** packaging of this file.  Please review the following information to | 
|---|
| 33 | ** ensure the GNU General Public License version 3.0 requirements will be | 
|---|
| 34 | ** met: http://www.gnu.org/copyleft/gpl.html. | 
|---|
| 35 | ** | 
|---|
| 36 | ** If you are unsure which license is appropriate for your use, please | 
|---|
| 37 | ** contact the sales department at qt-sales@nokia.com. | 
|---|
| 38 | ** $QT_END_LICENSE$ | 
|---|
| 39 | ** | 
|---|
| 40 | ****************************************************************************/ | 
|---|
| 41 |  | 
|---|
| 42 | #include "qstyleditemdelegate.h" | 
|---|
| 43 |  | 
|---|
| 44 | #ifndef QT_NO_ITEMVIEWS | 
|---|
| 45 | #include <qabstractitemmodel.h> | 
|---|
| 46 | #include <qapplication.h> | 
|---|
| 47 | #include <qbrush.h> | 
|---|
| 48 | #include <qlineedit.h> | 
|---|
| 49 | #include <qtextedit.h> | 
|---|
| 50 | #include <qpainter.h> | 
|---|
| 51 | #include <qpalette.h> | 
|---|
| 52 | #include <qpoint.h> | 
|---|
| 53 | #include <qrect.h> | 
|---|
| 54 | #include <qsize.h> | 
|---|
| 55 | #include <qstyle.h> | 
|---|
| 56 | #include <qdatetime.h> | 
|---|
| 57 | #include <qstyleoption.h> | 
|---|
| 58 | #include <qevent.h> | 
|---|
| 59 | #include <qpixmap.h> | 
|---|
| 60 | #include <qbitmap.h> | 
|---|
| 61 | #include <qpixmapcache.h> | 
|---|
| 62 | #include <qitemeditorfactory.h> | 
|---|
| 63 | #include <private/qitemeditorfactory_p.h> | 
|---|
| 64 | #include <qmetaobject.h> | 
|---|
| 65 | #include <qtextlayout.h> | 
|---|
| 66 | #include <private/qobject_p.h> | 
|---|
| 67 | #include <private/qdnd_p.h> | 
|---|
| 68 | #include <private/qtextengine_p.h> | 
|---|
| 69 | #include <private/qlayoutengine_p.h> | 
|---|
| 70 | #include <qdebug.h> | 
|---|
| 71 | #include <qlocale.h> | 
|---|
| 72 | #include <qdialog.h> | 
|---|
| 73 | #include <qtableview.h> | 
|---|
| 74 |  | 
|---|
| 75 | #include <limits.h> | 
|---|
| 76 |  | 
|---|
| 77 | QT_BEGIN_NAMESPACE | 
|---|
| 78 |  | 
|---|
| 79 | class QStyledItemDelegatePrivate : public QObjectPrivate | 
|---|
| 80 | { | 
|---|
| 81 | Q_DECLARE_PUBLIC(QStyledItemDelegate) | 
|---|
| 82 |  | 
|---|
| 83 | public: | 
|---|
| 84 | QStyledItemDelegatePrivate() : factory(0) { } | 
|---|
| 85 |  | 
|---|
| 86 | static const QWidget *widget(const QStyleOptionViewItem &option) | 
|---|
| 87 | { | 
|---|
| 88 | if (const QStyleOptionViewItemV3 *v3 = qstyleoption_cast<const QStyleOptionViewItemV3 *>(&option)) | 
|---|
| 89 | return v3->widget; | 
|---|
| 90 | return 0; | 
|---|
| 91 | } | 
|---|
| 92 |  | 
|---|
| 93 | const QItemEditorFactory *editorFactory() const | 
|---|
| 94 | { | 
|---|
| 95 | return factory ? factory : QItemEditorFactory::defaultFactory(); | 
|---|
| 96 | } | 
|---|
| 97 |  | 
|---|
| 98 | void _q_commitDataAndCloseEditor(QWidget *editor) | 
|---|
| 99 | { | 
|---|
| 100 | Q_Q(QStyledItemDelegate); | 
|---|
| 101 | emit q->commitData(editor); | 
|---|
| 102 | emit q->closeEditor(editor, QAbstractItemDelegate::SubmitModelCache); | 
|---|
| 103 | } | 
|---|
| 104 | QItemEditorFactory *factory; | 
|---|
| 105 | }; | 
|---|
| 106 |  | 
|---|
| 107 | /*! | 
|---|
| 108 | \class QStyledItemDelegate | 
|---|
| 109 |  | 
|---|
| 110 | \brief The QStyledItemDelegate class provides display and editing facilities for | 
|---|
| 111 | data items from a model. | 
|---|
| 112 |  | 
|---|
| 113 | \ingroup model-view | 
|---|
| 114 | \mainclass | 
|---|
| 115 | \since 4.4 | 
|---|
| 116 |  | 
|---|
| 117 | When displaying data from models in Qt item views, e.g., a | 
|---|
| 118 | QTableView, the individual items are drawn by a delegate. Also, | 
|---|
| 119 | when an item is edited, it provides an editor widget, which is | 
|---|
| 120 | placed on top of the item view while editing takes place. | 
|---|
| 121 | QStyledItemDelegate is the default delegate for all Qt item | 
|---|
| 122 | views, and is installed upon them when they are created. | 
|---|
| 123 |  | 
|---|
| 124 | The QStyledItemDelegate class is one of the \l{Model/View Classes} | 
|---|
| 125 | and is part of Qt's \l{Model/View Programming}{model/view | 
|---|
| 126 | framework}. The delegate allows the display and editing of items | 
|---|
| 127 | to be developed independently from the model and view. | 
|---|
| 128 |  | 
|---|
| 129 | The data of items in models are assigned an | 
|---|
| 130 | \l{Qt::}{ItemDataRole}; each item can store a QVariant for each | 
|---|
| 131 | role. QStyledItemDelegate implements display and editing for the | 
|---|
| 132 | most common datatypes expected by users, including booleans, | 
|---|
| 133 | integers, and strings. | 
|---|
| 134 |  | 
|---|
| 135 | The data will be drawn differently depending on which role they | 
|---|
| 136 | have in the model. The following table describes the roles and the | 
|---|
| 137 | data types the delegate can handle for each of them. It is often | 
|---|
| 138 | sufficient to ensure that the model returns appropriate data for | 
|---|
| 139 | each of the roles to determine the appearance of items in views. | 
|---|
| 140 |  | 
|---|
| 141 | \table | 
|---|
| 142 | \header \o Role \o Accepted Types | 
|---|
| 143 | \omit | 
|---|
| 144 | \row    \o \l Qt::AccessibleDescriptionRole \o QString | 
|---|
| 145 | \row    \o \l Qt::AccessibleTextRole \o QString | 
|---|
| 146 | \endomit | 
|---|
| 147 | \row    \o \l Qt::BackgroundRole \o QBrush | 
|---|
| 148 | \row    \o \l Qt::BackgroundColorRole \o QColor (obsolete; use Qt::BackgroundRole instead) | 
|---|
| 149 | \row    \o \l Qt::CheckStateRole \o Qt::CheckState | 
|---|
| 150 | \row    \o \l Qt::DecorationRole \o QIcon and QColor | 
|---|
| 151 | \row    \o \l Qt::DisplayRole \o QString and types with a string representation | 
|---|
| 152 | \row    \o \l Qt::EditRole \o See QItemEditorFactory for details | 
|---|
| 153 | \row    \o \l Qt::FontRole \o QFont | 
|---|
| 154 | \row    \o \l Qt::SizeHintRole \o QSize | 
|---|
| 155 | \omit | 
|---|
| 156 | \row    \o \l Qt::StatusTipRole \o | 
|---|
| 157 | \endomit | 
|---|
| 158 | \row    \o \l Qt::TextAlignmentRole \o Qt::Alignment | 
|---|
| 159 | \row    \o \l Qt::ForegroundRole \o QBrush | 
|---|
| 160 | \row    \o \l Qt::TextColorRole \o QColor (obsolete; use Qt::ForegroundRole instead) | 
|---|
| 161 | \omit | 
|---|
| 162 | \row    \o \l Qt::ToolTipRole | 
|---|
| 163 | \row    \o \l Qt::WhatsThisRole | 
|---|
| 164 | \endomit | 
|---|
| 165 | \endtable | 
|---|
| 166 |  | 
|---|
| 167 | Editors are created with a QItemEditorFactory; a default static | 
|---|
| 168 | instance provided by QItemEditorFactory is installed on all item | 
|---|
| 169 | delegates. You can set a custom factory using | 
|---|
| 170 | setItemEditorFactory() or set a new default factory with | 
|---|
| 171 | QItemEditorFactory::setDefaultFactory(). It is the data stored in | 
|---|
| 172 | the item model with the \l{Qt::}{EditRole} that is edited. See the | 
|---|
| 173 | QItemEditorFactory class for a more high-level introduction to | 
|---|
| 174 | item editor factories. The \l{Color Editor Factory Example}{Color | 
|---|
| 175 | Editor Factory} example shows how to create custom editors with a | 
|---|
| 176 | factory. | 
|---|
| 177 |  | 
|---|
| 178 | \section1 Subclassing QStyledItemDelegate | 
|---|
| 179 |  | 
|---|
| 180 | If the delegate does not support painting of the data types you | 
|---|
| 181 | need or you want to customize the drawing of items, you need to | 
|---|
| 182 | subclass QStyledItemDelegate, and reimplement paint() and possibly | 
|---|
| 183 | sizeHint(). The paint() function is called individually for each | 
|---|
| 184 | item, and with sizeHint(), you can specify the hint for each | 
|---|
| 185 | of them. | 
|---|
| 186 |  | 
|---|
| 187 | When reimplementing paint(), one would typically handle the | 
|---|
| 188 | datatypes one would like to draw and use the superclass | 
|---|
| 189 | implementation for other types. | 
|---|
| 190 |  | 
|---|
| 191 | The painting of check box indicators are performed by the current | 
|---|
| 192 | style. The style also specifies the size and the bounding | 
|---|
| 193 | rectangles in which to draw the data for the different data roles. | 
|---|
| 194 | The bounding rectangle of the item itself is also calculated by | 
|---|
| 195 | the style. When drawing already supported datatypes, it is | 
|---|
| 196 | therefore a good idea to ask the style for these bounding | 
|---|
| 197 | rectangles. The QStyle class description describes this in | 
|---|
| 198 | more detail. | 
|---|
| 199 |  | 
|---|
| 200 | If you wish to change any of the bounding rectangles calculated by | 
|---|
| 201 | the style or the painting of check box indicators, you can | 
|---|
| 202 | subclass QStyle. Note, however, that the size of the items can | 
|---|
| 203 | also be affected by reimplementing sizeHint(). | 
|---|
| 204 |  | 
|---|
| 205 | It is possible for a custom delegate to provide editors | 
|---|
| 206 | without the use of an editor item factory. In this case, the | 
|---|
| 207 | following virtual functions must be reimplemented: | 
|---|
| 208 |  | 
|---|
| 209 | \list | 
|---|
| 210 | \o createEditor() returns the widget used to change data from the model | 
|---|
| 211 | and can be reimplemented to customize editing behavior. | 
|---|
| 212 | \o setEditorData() provides the widget with data to manipulate. | 
|---|
| 213 | \o updateEditorGeometry() ensures that the editor is displayed correctly | 
|---|
| 214 | with respect to the item view. | 
|---|
| 215 | \o setModelData() returns updated data to the model. | 
|---|
| 216 | \endlist | 
|---|
| 217 |  | 
|---|
| 218 | The \l{Star Delegate Example}{Star Delegate} example creates | 
|---|
| 219 | editors by reimplementing these methods. | 
|---|
| 220 |  | 
|---|
| 221 | \section1 QStyledItemDelegate vs. QItemDelegate | 
|---|
| 222 |  | 
|---|
| 223 | Since Qt 4.4, there are two delegate classes: QItemDelegate and | 
|---|
| 224 | QStyledItemDelegate. However, the default delegate is QStyledItemDelegate. | 
|---|
| 225 | These two classes are independent alternatives to painting and providing | 
|---|
| 226 | editors for items in views. The difference between them is that | 
|---|
| 227 | QStyledItemDelegate uses the current style to paint its items. We therefore | 
|---|
| 228 | recommend using QStyledItemDelegate as the base class when implementing | 
|---|
| 229 | custom delegates or when working with Qt style sheets. The code required | 
|---|
| 230 | for either class should be equal unless the custom delegate needs to use | 
|---|
| 231 | the style for drawing. | 
|---|
| 232 |  | 
|---|
| 233 | If you wish to customize the painting of item views, you should | 
|---|
| 234 | implement a custom style. Please see the QStyle class | 
|---|
| 235 | documentation for details. | 
|---|
| 236 |  | 
|---|
| 237 | \sa {Delegate Classes}, QItemDelegate, QAbstractItemDelegate, QStyle, | 
|---|
| 238 | {Spin Box Delegate Example}, {Star Delegate Example}, {Color | 
|---|
| 239 | Editor Factory Example} | 
|---|
| 240 | */ | 
|---|
| 241 |  | 
|---|
| 242 |  | 
|---|
| 243 | /*! | 
|---|
| 244 | Constructs an item delegate with the given \a parent. | 
|---|
| 245 | */ | 
|---|
| 246 | QStyledItemDelegate::QStyledItemDelegate(QObject *parent) | 
|---|
| 247 | : QAbstractItemDelegate(*new QStyledItemDelegatePrivate(), parent) | 
|---|
| 248 | { | 
|---|
| 249 | } | 
|---|
| 250 |  | 
|---|
| 251 | /*! | 
|---|
| 252 | Destroys the item delegate. | 
|---|
| 253 | */ | 
|---|
| 254 | QStyledItemDelegate::~QStyledItemDelegate() | 
|---|
| 255 | { | 
|---|
| 256 | } | 
|---|
| 257 |  | 
|---|
| 258 | /*! | 
|---|
| 259 | This function returns the string that the delegate will use to display the | 
|---|
| 260 | Qt::DisplayRole of the model in \a locale. \a value is the value of the Qt::DisplayRole | 
|---|
| 261 | provided by the model. | 
|---|
| 262 |  | 
|---|
| 263 | The default implementation uses the QLocale::toString to convert \a value into | 
|---|
| 264 | a QString. | 
|---|
| 265 | */ | 
|---|
| 266 | QString QStyledItemDelegate::displayText(const QVariant &value, const QLocale& locale) const | 
|---|
| 267 | { | 
|---|
| 268 | QString text; | 
|---|
| 269 | switch (value.type()) { | 
|---|
| 270 | case QVariant::Double: | 
|---|
| 271 | text = locale.toString(value.toDouble()); | 
|---|
| 272 | break; | 
|---|
| 273 | case QVariant::Int: | 
|---|
| 274 | case QVariant::LongLong: | 
|---|
| 275 | text = locale.toString(value.toLongLong()); | 
|---|
| 276 | break; | 
|---|
| 277 | case QVariant::UInt: | 
|---|
| 278 | case QVariant::ULongLong: | 
|---|
| 279 | text = locale.toString(value.toULongLong()); | 
|---|
| 280 | break; | 
|---|
| 281 | case QVariant::Date: | 
|---|
| 282 | text = locale.toString(value.toDate(), QLocale::ShortFormat); | 
|---|
| 283 | break; | 
|---|
| 284 | case QVariant::Time: | 
|---|
| 285 | text = locale.toString(value.toTime(), QLocale::ShortFormat); | 
|---|
| 286 | break; | 
|---|
| 287 | case QVariant::DateTime: | 
|---|
| 288 | text = locale.toString(value.toDateTime().date(), QLocale::ShortFormat); | 
|---|
| 289 | text += QLatin1Char(' '); | 
|---|
| 290 | text += locale.toString(value.toDateTime().time(), QLocale::ShortFormat); | 
|---|
| 291 | break; | 
|---|
| 292 | default: | 
|---|
| 293 | // convert new lines into line separators | 
|---|
| 294 | text = value.toString(); | 
|---|
| 295 | for (int i = 0; i < text.count(); ++i) { | 
|---|
| 296 | if (text.at(i) == QLatin1Char('\n')) | 
|---|
| 297 | text[i] = QChar::LineSeparator; | 
|---|
| 298 | } | 
|---|
| 299 | break; | 
|---|
| 300 | } | 
|---|
| 301 | return text; | 
|---|
| 302 | } | 
|---|
| 303 |  | 
|---|
| 304 | /*! | 
|---|
| 305 | Initialize \a option with the values using the index \a index. This method | 
|---|
| 306 | is useful for subclasses when they need a QStyleOptionViewItem, but don't want | 
|---|
| 307 | to fill in all the information themselves. This function will check the version | 
|---|
| 308 | of the QStyleOptionViewItem and fill in the additional values for a | 
|---|
| 309 | QStyleOptionViewItemV2, QStyleOptionViewItemV3 and QStyleOptionViewItemV4. | 
|---|
| 310 |  | 
|---|
| 311 | \sa QStyleOption::initFrom() | 
|---|
| 312 | */ | 
|---|
| 313 | void QStyledItemDelegate::initStyleOption(QStyleOptionViewItem *option, | 
|---|
| 314 | const QModelIndex &index) const | 
|---|
| 315 | { | 
|---|
| 316 | QVariant value = index.data(Qt::FontRole); | 
|---|
| 317 | if (value.isValid() && !value.isNull()) { | 
|---|
| 318 | option->font = qvariant_cast<QFont>(value).resolve(option->font); | 
|---|
| 319 | option->fontMetrics = QFontMetrics(option->font); | 
|---|
| 320 | } | 
|---|
| 321 |  | 
|---|
| 322 | value = index.data(Qt::TextAlignmentRole); | 
|---|
| 323 | if (value.isValid() && !value.isNull()) | 
|---|
| 324 | option->displayAlignment = (Qt::Alignment)value.toInt(); | 
|---|
| 325 |  | 
|---|
| 326 | value = index.data(Qt::ForegroundRole); | 
|---|
| 327 | if (qVariantCanConvert<QBrush>(value)) | 
|---|
| 328 | option->palette.setBrush(QPalette::Text, qvariant_cast<QBrush>(value)); | 
|---|
| 329 |  | 
|---|
| 330 | if (QStyleOptionViewItemV4 *v4 = qstyleoption_cast<QStyleOptionViewItemV4 *>(option)) { | 
|---|
| 331 | v4->index = index; | 
|---|
| 332 | QVariant value = index.data(Qt::CheckStateRole); | 
|---|
| 333 | if (value.isValid() && !value.isNull()) { | 
|---|
| 334 | v4->features |= QStyleOptionViewItemV2::HasCheckIndicator; | 
|---|
| 335 | v4->checkState = static_cast<Qt::CheckState>(value.toInt()); | 
|---|
| 336 | } | 
|---|
| 337 |  | 
|---|
| 338 | value = index.data(Qt::DecorationRole); | 
|---|
| 339 | if (value.isValid() && !value.isNull()) { | 
|---|
| 340 | v4->features |= QStyleOptionViewItemV2::HasDecoration; | 
|---|
| 341 | switch (value.type()) { | 
|---|
| 342 | case QVariant::Icon: { | 
|---|
| 343 | v4->icon = qvariant_cast<QIcon>(value); | 
|---|
| 344 | QIcon::Mode mode; | 
|---|
| 345 | if (!(option->state & QStyle::State_Enabled)) | 
|---|
| 346 | mode = QIcon::Disabled; | 
|---|
| 347 | else if (option->state & QStyle::State_Selected) | 
|---|
| 348 | mode = QIcon::Selected; | 
|---|
| 349 | else | 
|---|
| 350 | mode = QIcon::Normal; | 
|---|
| 351 | QIcon::State state = option->state & QStyle::State_Open ? QIcon::On : QIcon::Off; | 
|---|
| 352 | v4->decorationSize = v4->icon.actualSize(option->decorationSize, mode, state); | 
|---|
| 353 | break; | 
|---|
| 354 | } | 
|---|
| 355 | case QVariant::Color: { | 
|---|
| 356 | QPixmap pixmap(option->decorationSize); | 
|---|
| 357 | pixmap.fill(qvariant_cast<QColor>(value)); | 
|---|
| 358 | v4->icon = QIcon(pixmap); | 
|---|
| 359 | break; | 
|---|
| 360 | } | 
|---|
| 361 | case QVariant::Image: { | 
|---|
| 362 | QImage image = qvariant_cast<QImage>(value); | 
|---|
| 363 | v4->icon = QIcon(QPixmap::fromImage(image)); | 
|---|
| 364 | v4->decorationSize = image.size(); | 
|---|
| 365 | break; | 
|---|
| 366 | } | 
|---|
| 367 | case QVariant::Pixmap: { | 
|---|
| 368 | QPixmap pixmap = qvariant_cast<QPixmap>(value); | 
|---|
| 369 | v4->icon = QIcon(pixmap); | 
|---|
| 370 | v4->decorationSize = pixmap.size(); | 
|---|
| 371 | break; | 
|---|
| 372 | } | 
|---|
| 373 | default: | 
|---|
| 374 | break; | 
|---|
| 375 | } | 
|---|
| 376 | } | 
|---|
| 377 |  | 
|---|
| 378 | value = index.data(Qt::DisplayRole); | 
|---|
| 379 | if (value.isValid() && !value.isNull()) { | 
|---|
| 380 | v4->features |= QStyleOptionViewItemV2::HasDisplay; | 
|---|
| 381 | v4->text = displayText(value, v4->locale); | 
|---|
| 382 | } | 
|---|
| 383 |  | 
|---|
| 384 | v4->backgroundBrush = qvariant_cast<QBrush>(index.data(Qt::BackgroundRole)); | 
|---|
| 385 | } | 
|---|
| 386 | } | 
|---|
| 387 |  | 
|---|
| 388 | /*! | 
|---|
| 389 | Renders the delegate using the given \a painter and style \a option for | 
|---|
| 390 | the item specified by \a index. | 
|---|
| 391 |  | 
|---|
| 392 | This function paints the item using the view's QStyle. | 
|---|
| 393 |  | 
|---|
| 394 | When reimplementing paint in a subclass. Use the initStyleOption() | 
|---|
| 395 | to set up the \a option in the same way as the | 
|---|
| 396 | QStyledItemDelegate; the option will always be an instance of | 
|---|
| 397 | QStyleOptionViewItemV4. Please see its class description for | 
|---|
| 398 | information on its contents. | 
|---|
| 399 |  | 
|---|
| 400 | Whenever possible, use the \a option while painting. | 
|---|
| 401 | Especially its \l{QStyleOption::}{rect} variable to decide | 
|---|
| 402 | where to draw and its \l{QStyleOption::}{state} to determine | 
|---|
| 403 | if it is enabled or selected. | 
|---|
| 404 |  | 
|---|
| 405 | After painting, you should ensure that the painter is returned to | 
|---|
| 406 | its the state it was supplied in when this function was called. | 
|---|
| 407 | For example, it may be useful to call QPainter::save() before | 
|---|
| 408 | painting and QPainter::restore() afterwards. | 
|---|
| 409 |  | 
|---|
| 410 | \sa QItemDelegate::paint(), QStyle::drawControl(), QStyle::CE_ItemViewItem | 
|---|
| 411 | */ | 
|---|
| 412 | void QStyledItemDelegate::paint(QPainter *painter, | 
|---|
| 413 | const QStyleOptionViewItem &option, const QModelIndex &index) const | 
|---|
| 414 | { | 
|---|
| 415 | Q_ASSERT(index.isValid()); | 
|---|
| 416 |  | 
|---|
| 417 | QStyleOptionViewItemV4 opt = option; | 
|---|
| 418 | initStyleOption(&opt, index); | 
|---|
| 419 |  | 
|---|
| 420 | const QWidget *widget = QStyledItemDelegatePrivate::widget(option); | 
|---|
| 421 | QStyle *style = widget ? widget->style() : QApplication::style(); | 
|---|
| 422 | style->drawControl(QStyle::CE_ItemViewItem, &opt, painter, widget); | 
|---|
| 423 | } | 
|---|
| 424 |  | 
|---|
| 425 | /*! | 
|---|
| 426 | Returns the size needed by the delegate to display the item | 
|---|
| 427 | specified by \a index, taking into account the style information | 
|---|
| 428 | provided by \a option. | 
|---|
| 429 |  | 
|---|
| 430 | This function uses the view's QStyle to determine the size of the | 
|---|
| 431 | item. | 
|---|
| 432 |  | 
|---|
| 433 | \sa QStyle::sizeFromContents(), QStyle::CT_ItemViewItem | 
|---|
| 434 | */ | 
|---|
| 435 | QSize QStyledItemDelegate::sizeHint(const QStyleOptionViewItem &option, | 
|---|
| 436 | const QModelIndex &index) const | 
|---|
| 437 | { | 
|---|
| 438 | QVariant value = index.data(Qt::SizeHintRole); | 
|---|
| 439 | if (value.isValid()) | 
|---|
| 440 | return qvariant_cast<QSize>(value); | 
|---|
| 441 |  | 
|---|
| 442 | QStyleOptionViewItemV4 opt = option; | 
|---|
| 443 | initStyleOption(&opt, index); | 
|---|
| 444 | const QWidget *widget = QStyledItemDelegatePrivate::widget(option); | 
|---|
| 445 | QStyle *style = widget ? widget->style() : QApplication::style(); | 
|---|
| 446 | return style->sizeFromContents(QStyle::CT_ItemViewItem, &opt, QSize(), widget); | 
|---|
| 447 | } | 
|---|
| 448 |  | 
|---|
| 449 | /*! | 
|---|
| 450 | Returns the widget used to edit the item specified by \a index | 
|---|
| 451 | for editing. The \a parent widget and style \a option are used to | 
|---|
| 452 | control how the editor widget appears. | 
|---|
| 453 |  | 
|---|
| 454 | \sa QAbstractItemDelegate::createEditor() | 
|---|
| 455 | */ | 
|---|
| 456 | QWidget *QStyledItemDelegate::createEditor(QWidget *parent, | 
|---|
| 457 | const QStyleOptionViewItem &, | 
|---|
| 458 | const QModelIndex &index) const | 
|---|
| 459 | { | 
|---|
| 460 | Q_D(const QStyledItemDelegate); | 
|---|
| 461 | if (!index.isValid()) | 
|---|
| 462 | return 0; | 
|---|
| 463 | QVariant::Type t = static_cast<QVariant::Type>(index.data(Qt::EditRole).userType()); | 
|---|
| 464 | return d->editorFactory()->createEditor(t, parent); | 
|---|
| 465 | } | 
|---|
| 466 |  | 
|---|
| 467 | /*! | 
|---|
| 468 | Sets the data to be displayed and edited by the \a editor from the | 
|---|
| 469 | data model item specified by the model \a index. | 
|---|
| 470 |  | 
|---|
| 471 | The default implementation stores the data in the \a editor | 
|---|
| 472 | widget's \l {Qt's Property System} {user property}. | 
|---|
| 473 |  | 
|---|
| 474 | \sa QMetaProperty::isUser() | 
|---|
| 475 | */ | 
|---|
| 476 | void QStyledItemDelegate::setEditorData(QWidget *editor, const QModelIndex &index) const | 
|---|
| 477 | { | 
|---|
| 478 | #ifdef QT_NO_PROPERTIES | 
|---|
| 479 | Q_UNUSED(editor); | 
|---|
| 480 | Q_UNUSED(index); | 
|---|
| 481 | #else | 
|---|
| 482 | Q_D(const QStyledItemDelegate); | 
|---|
| 483 | QVariant v = index.data(Qt::EditRole); | 
|---|
| 484 | QByteArray n = editor->metaObject()->userProperty().name(); | 
|---|
| 485 |  | 
|---|
| 486 | // ### Qt 5: remove | 
|---|
| 487 | // A work-around for missing "USER true" in qdatetimeedit.h for | 
|---|
| 488 | // QTimeEdit's time property and QDateEdit's date property. | 
|---|
| 489 | // It only triggers if the default user property "dateTime" is | 
|---|
| 490 | // reported for QTimeEdit and QDateEdit. | 
|---|
| 491 | if (n == "dateTime") { | 
|---|
| 492 | if (editor->inherits("QTimeEdit")) | 
|---|
| 493 | n = "time"; | 
|---|
| 494 | else if (editor->inherits("QDateEdit")) | 
|---|
| 495 | n = "date"; | 
|---|
| 496 | } | 
|---|
| 497 |  | 
|---|
| 498 | // ### Qt 5: give QComboBox a USER property | 
|---|
| 499 | if (n.isEmpty() && editor->inherits("QComboBox")) | 
|---|
| 500 | n = d->editorFactory()->valuePropertyName(static_cast<QVariant::Type>(v.userType())); | 
|---|
| 501 | if (!n.isEmpty()) { | 
|---|
| 502 | if (!v.isValid()) | 
|---|
| 503 | v = QVariant(editor->property(n).userType(), (const void *)0); | 
|---|
| 504 | editor->setProperty(n, v); | 
|---|
| 505 | } | 
|---|
| 506 | #endif | 
|---|
| 507 | } | 
|---|
| 508 |  | 
|---|
| 509 | /*! | 
|---|
| 510 | Gets data drom the \a editor widget and stores it in the specified | 
|---|
| 511 | \a model at the item \a index. | 
|---|
| 512 |  | 
|---|
| 513 | The default implementation gets the value to be stored in the data | 
|---|
| 514 | model from the \a editor widget's \l {Qt's Property System} {user | 
|---|
| 515 | property}. | 
|---|
| 516 |  | 
|---|
| 517 | \sa QMetaProperty::isUser() | 
|---|
| 518 | */ | 
|---|
| 519 | void QStyledItemDelegate::setModelData(QWidget *editor, | 
|---|
| 520 | QAbstractItemModel *model, | 
|---|
| 521 | const QModelIndex &index) const | 
|---|
| 522 | { | 
|---|
| 523 | #ifdef QT_NO_PROPERTIES | 
|---|
| 524 | Q_UNUSED(model); | 
|---|
| 525 | Q_UNUSED(editor); | 
|---|
| 526 | Q_UNUSED(index); | 
|---|
| 527 | #else | 
|---|
| 528 | Q_D(const QStyledItemDelegate); | 
|---|
| 529 | Q_ASSERT(model); | 
|---|
| 530 | Q_ASSERT(editor); | 
|---|
| 531 | QByteArray n = editor->metaObject()->userProperty().name(); | 
|---|
| 532 | if (n.isEmpty()) | 
|---|
| 533 | n = d->editorFactory()->valuePropertyName( | 
|---|
| 534 | static_cast<QVariant::Type>(model->data(index, Qt::EditRole).userType())); | 
|---|
| 535 | if (!n.isEmpty()) | 
|---|
| 536 | model->setData(index, editor->property(n), Qt::EditRole); | 
|---|
| 537 | #endif | 
|---|
| 538 | } | 
|---|
| 539 |  | 
|---|
| 540 | /*! | 
|---|
| 541 | Updates the \a editor for the item specified by \a index | 
|---|
| 542 | according to the style \a option given. | 
|---|
| 543 | */ | 
|---|
| 544 | void QStyledItemDelegate::updateEditorGeometry(QWidget *editor, | 
|---|
| 545 | const QStyleOptionViewItem &option, | 
|---|
| 546 | const QModelIndex &index) const | 
|---|
| 547 | { | 
|---|
| 548 | if (!editor) | 
|---|
| 549 | return; | 
|---|
| 550 | Q_ASSERT(index.isValid()); | 
|---|
| 551 | const QWidget *widget = QStyledItemDelegatePrivate::widget(option); | 
|---|
| 552 |  | 
|---|
| 553 | QStyleOptionViewItemV4 opt = option; | 
|---|
| 554 | initStyleOption(&opt, index); | 
|---|
| 555 | // let the editor take up all available space | 
|---|
| 556 | //if the editor is not a QLineEdit | 
|---|
| 557 | //or it is in a QTableView | 
|---|
| 558 | #if !defined(QT_NO_TABLEVIEW) && !defined(QT_NO_LINEEDIT) | 
|---|
| 559 | if (qobject_cast<QExpandingLineEdit*>(editor) && !qobject_cast<const QTableView*>(widget)) | 
|---|
| 560 | opt.showDecorationSelected = editor->style()->styleHint(QStyle::SH_ItemView_ShowDecorationSelected, 0, editor); | 
|---|
| 561 | else | 
|---|
| 562 | #endif | 
|---|
| 563 | opt.showDecorationSelected = true; | 
|---|
| 564 |  | 
|---|
| 565 | QStyle *style = widget ? widget->style() : QApplication::style(); | 
|---|
| 566 | QRect geom = style->subElementRect(QStyle::SE_ItemViewItemText, &opt, widget); | 
|---|
| 567 | if ( editor->layoutDirection() == Qt::RightToLeft) { | 
|---|
| 568 | const int delta = qSmartMinSize(editor).width() - geom.width(); | 
|---|
| 569 | if (delta > 0) { | 
|---|
| 570 | //we need to widen the geometry | 
|---|
| 571 | geom.adjust(-delta, 0, 0, 0); | 
|---|
| 572 | } | 
|---|
| 573 | } | 
|---|
| 574 |  | 
|---|
| 575 | editor->setGeometry(geom); | 
|---|
| 576 | } | 
|---|
| 577 |  | 
|---|
| 578 | /*! | 
|---|
| 579 | Returns the editor factory used by the item delegate. | 
|---|
| 580 | If no editor factory is set, the function will return null. | 
|---|
| 581 |  | 
|---|
| 582 | \sa setItemEditorFactory() | 
|---|
| 583 | */ | 
|---|
| 584 | QItemEditorFactory *QStyledItemDelegate::itemEditorFactory() const | 
|---|
| 585 | { | 
|---|
| 586 | Q_D(const QStyledItemDelegate); | 
|---|
| 587 | return d->factory; | 
|---|
| 588 | } | 
|---|
| 589 |  | 
|---|
| 590 | /*! | 
|---|
| 591 | Sets the editor factory to be used by the item delegate to be the \a factory | 
|---|
| 592 | specified. If no editor factory is set, the item delegate will use the | 
|---|
| 593 | default editor factory. | 
|---|
| 594 |  | 
|---|
| 595 | \sa itemEditorFactory() | 
|---|
| 596 | */ | 
|---|
| 597 | void QStyledItemDelegate::setItemEditorFactory(QItemEditorFactory *factory) | 
|---|
| 598 | { | 
|---|
| 599 | Q_D(QStyledItemDelegate); | 
|---|
| 600 | d->factory = factory; | 
|---|
| 601 | } | 
|---|
| 602 |  | 
|---|
| 603 |  | 
|---|
| 604 | /*! | 
|---|
| 605 | \fn bool QStyledItemDelegate::eventFilter(QObject *editor, QEvent *event) | 
|---|
| 606 |  | 
|---|
| 607 | Returns true if the given \a editor is a valid QWidget and the | 
|---|
| 608 | given \a event is handled; otherwise returns false. The following | 
|---|
| 609 | key press events are handled by default: | 
|---|
| 610 |  | 
|---|
| 611 | \list | 
|---|
| 612 | \o \gui Tab | 
|---|
| 613 | \o \gui Backtab | 
|---|
| 614 | \o \gui Enter | 
|---|
| 615 | \o \gui Return | 
|---|
| 616 | \o \gui Esc | 
|---|
| 617 | \endlist | 
|---|
| 618 |  | 
|---|
| 619 | In the case of \gui Tab, \gui Backtab, \gui Enter and \gui Return | 
|---|
| 620 | key press events, the \a editor's data is comitted to the model | 
|---|
| 621 | and the editor is closed. If the \a event is a \gui Tab key press | 
|---|
| 622 | the view will open an editor on the next item in the | 
|---|
| 623 | view. Likewise, if the \a event is a \gui Backtab key press the | 
|---|
| 624 | view will open an editor on the \e previous item in the view. | 
|---|
| 625 |  | 
|---|
| 626 | If the event is a \gui Esc key press event, the \a editor is | 
|---|
| 627 | closed \e without committing its data. | 
|---|
| 628 |  | 
|---|
| 629 | \sa commitData(), closeEditor() | 
|---|
| 630 | */ | 
|---|
| 631 | bool QStyledItemDelegate::eventFilter(QObject *object, QEvent *event) | 
|---|
| 632 | { | 
|---|
| 633 | QWidget *editor = qobject_cast<QWidget*>(object); | 
|---|
| 634 | if (!editor) | 
|---|
| 635 | return false; | 
|---|
| 636 | if (event->type() == QEvent::KeyPress) { | 
|---|
| 637 | switch (static_cast<QKeyEvent *>(event)->key()) { | 
|---|
| 638 | case Qt::Key_Tab: | 
|---|
| 639 | emit commitData(editor); | 
|---|
| 640 | emit closeEditor(editor, QAbstractItemDelegate::EditNextItem); | 
|---|
| 641 | return true; | 
|---|
| 642 | case Qt::Key_Backtab: | 
|---|
| 643 | emit commitData(editor); | 
|---|
| 644 | emit closeEditor(editor, QAbstractItemDelegate::EditPreviousItem); | 
|---|
| 645 | return true; | 
|---|
| 646 | case Qt::Key_Enter: | 
|---|
| 647 | case Qt::Key_Return: | 
|---|
| 648 | #ifndef QT_NO_TEXTEDIT | 
|---|
| 649 | if (qobject_cast<QTextEdit*>(editor)) | 
|---|
| 650 | return false; // don't filter enter key events for QTextEdit | 
|---|
| 651 | // We want the editor to be able to process the key press | 
|---|
| 652 | // before committing the data (e.g. so it can do | 
|---|
| 653 | // validation/fixup of the input). | 
|---|
| 654 | #endif // QT_NO_TEXTEDIT | 
|---|
| 655 | #ifndef QT_NO_LINEEDIT | 
|---|
| 656 | if (QLineEdit *e = qobject_cast<QLineEdit*>(editor)) | 
|---|
| 657 | if (!e->hasAcceptableInput()) | 
|---|
| 658 | return false; | 
|---|
| 659 | #endif // QT_NO_LINEEDIT | 
|---|
| 660 | QMetaObject::invokeMethod(this, "_q_commitDataAndCloseEditor", | 
|---|
| 661 | Qt::QueuedConnection, Q_ARG(QWidget*, editor)); | 
|---|
| 662 | return false; | 
|---|
| 663 | case Qt::Key_Escape: | 
|---|
| 664 | // don't commit data | 
|---|
| 665 | emit closeEditor(editor, QAbstractItemDelegate::RevertModelCache); | 
|---|
| 666 | break; | 
|---|
| 667 | default: | 
|---|
| 668 | return false; | 
|---|
| 669 | } | 
|---|
| 670 | if (editor->parentWidget()) | 
|---|
| 671 | editor->parentWidget()->setFocus(); | 
|---|
| 672 | return true; | 
|---|
| 673 | } else if (event->type() == QEvent::FocusOut || event->type() == QEvent::Hide) { | 
|---|
| 674 | //the Hide event will take care of he editors that are in fact complete dialogs | 
|---|
| 675 | if (!editor->isActiveWindow() || (QApplication::focusWidget() != editor)) { | 
|---|
| 676 | QWidget *w = QApplication::focusWidget(); | 
|---|
| 677 | while (w) { // don't worry about focus changes internally in the editor | 
|---|
| 678 | if (w == editor) | 
|---|
| 679 | return false; | 
|---|
| 680 | w = w->parentWidget(); | 
|---|
| 681 | } | 
|---|
| 682 | #ifndef QT_NO_DRAGANDDROP | 
|---|
| 683 | // The window may lose focus during an drag operation. | 
|---|
| 684 | // i.e when dragging involves the taskbar on Windows. | 
|---|
| 685 | if (QDragManager::self() && QDragManager::self()->object != 0) | 
|---|
| 686 | return false; | 
|---|
| 687 | #endif | 
|---|
| 688 | // Opening a modal dialog will start a new eventloop | 
|---|
| 689 | // that will process the deleteLater event. | 
|---|
| 690 | QWidget *activeModalWidget = QApplication::activeModalWidget(); | 
|---|
| 691 | if (activeModalWidget | 
|---|
| 692 | && !activeModalWidget->isAncestorOf(editor) | 
|---|
| 693 | && qobject_cast<QDialog*>(activeModalWidget)) | 
|---|
| 694 | return false; | 
|---|
| 695 | emit commitData(editor); | 
|---|
| 696 | emit closeEditor(editor, NoHint); | 
|---|
| 697 | } | 
|---|
| 698 | } else if (event->type() == QEvent::ShortcutOverride) { | 
|---|
| 699 | if (static_cast<QKeyEvent*>(event)->key() == Qt::Key_Escape) { | 
|---|
| 700 | event->accept(); | 
|---|
| 701 | return true; | 
|---|
| 702 | } | 
|---|
| 703 | } | 
|---|
| 704 | return false; | 
|---|
| 705 | } | 
|---|
| 706 |  | 
|---|
| 707 | /*! | 
|---|
| 708 | \reimp | 
|---|
| 709 | */ | 
|---|
| 710 | bool QStyledItemDelegate::editorEvent(QEvent *event, | 
|---|
| 711 | QAbstractItemModel *model, | 
|---|
| 712 | const QStyleOptionViewItem &option, | 
|---|
| 713 | const QModelIndex &index) | 
|---|
| 714 | { | 
|---|
| 715 | Q_ASSERT(event); | 
|---|
| 716 | Q_ASSERT(model); | 
|---|
| 717 |  | 
|---|
| 718 | // make sure that the item is checkable | 
|---|
| 719 | Qt::ItemFlags flags = model->flags(index); | 
|---|
| 720 | if (!(flags & Qt::ItemIsUserCheckable) || !(option.state & QStyle::State_Enabled) | 
|---|
| 721 | || !(flags & Qt::ItemIsEnabled)) | 
|---|
| 722 | return false; | 
|---|
| 723 |  | 
|---|
| 724 | // make sure that we have a check state | 
|---|
| 725 | QVariant value = index.data(Qt::CheckStateRole); | 
|---|
| 726 | if (!value.isValid()) | 
|---|
| 727 | return false; | 
|---|
| 728 |  | 
|---|
| 729 | const QWidget *widget = QStyledItemDelegatePrivate::widget(option); | 
|---|
| 730 | QStyle *style = widget ? widget->style() : QApplication::style(); | 
|---|
| 731 |  | 
|---|
| 732 | // make sure that we have the right event type | 
|---|
| 733 | if ((event->type() == QEvent::MouseButtonRelease) | 
|---|
| 734 | || (event->type() == QEvent::MouseButtonDblClick)) { | 
|---|
| 735 | QStyleOptionViewItemV4 viewOpt(option); | 
|---|
| 736 | initStyleOption(&viewOpt, index); | 
|---|
| 737 | QRect checkRect = style->subElementRect(QStyle::SE_ItemViewItemCheckIndicator, &viewOpt, widget); | 
|---|
| 738 | QMouseEvent *me = static_cast<QMouseEvent*>(event); | 
|---|
| 739 | if (me->button() != Qt::LeftButton || !checkRect.contains(me->pos())) | 
|---|
| 740 | return false; | 
|---|
| 741 |  | 
|---|
| 742 | // eat the double click events inside the check rect | 
|---|
| 743 | if (event->type() == QEvent::MouseButtonDblClick) | 
|---|
| 744 | return true; | 
|---|
| 745 |  | 
|---|
| 746 | } else if (event->type() == QEvent::KeyPress) { | 
|---|
| 747 | if (static_cast<QKeyEvent*>(event)->key() != Qt::Key_Space | 
|---|
| 748 | && static_cast<QKeyEvent*>(event)->key() != Qt::Key_Select) | 
|---|
| 749 | return false; | 
|---|
| 750 | } else { | 
|---|
| 751 | return false; | 
|---|
| 752 | } | 
|---|
| 753 |  | 
|---|
| 754 | Qt::CheckState state = (static_cast<Qt::CheckState>(value.toInt()) == Qt::Checked | 
|---|
| 755 | ? Qt::Unchecked : Qt::Checked); | 
|---|
| 756 | return model->setData(index, state, Qt::CheckStateRole); | 
|---|
| 757 | } | 
|---|
| 758 |  | 
|---|
| 759 | QT_END_NAMESPACE | 
|---|
| 760 |  | 
|---|
| 761 | #include "moc_qstyleditemdelegate.cpp" | 
|---|
| 762 |  | 
|---|
| 763 | #endif // QT_NO_ITEMVIEWS | 
|---|