qtablewidget.h 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374
  1. /****************************************************************************
  2. **
  3. ** Copyright (C) 2016 The Qt Company Ltd.
  4. ** Contact: https://www.qt.io/licensing/
  5. **
  6. ** This file is part of the QtWidgets module of the Qt Toolkit.
  7. **
  8. ** $QT_BEGIN_LICENSE:LGPL$
  9. ** Commercial License Usage
  10. ** Licensees holding valid commercial Qt licenses may use this file in
  11. ** accordance with the commercial license agreement provided with the
  12. ** Software or, alternatively, in accordance with the terms contained in
  13. ** a written agreement between you and The Qt Company. For licensing terms
  14. ** and conditions see https://www.qt.io/terms-conditions. For further
  15. ** information use the contact form at https://www.qt.io/contact-us.
  16. **
  17. ** GNU Lesser General Public License Usage
  18. ** Alternatively, this file may be used under the terms of the GNU Lesser
  19. ** General Public License version 3 as published by the Free Software
  20. ** Foundation and appearing in the file LICENSE.LGPL3 included in the
  21. ** packaging of this file. Please review the following information to
  22. ** ensure the GNU Lesser General Public License version 3 requirements
  23. ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html.
  24. **
  25. ** GNU General Public License Usage
  26. ** Alternatively, this file may be used under the terms of the GNU
  27. ** General Public License version 2.0 or (at your option) the GNU General
  28. ** Public license version 3 or any later version approved by the KDE Free
  29. ** Qt Foundation. The licenses are as published by the Free Software
  30. ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3
  31. ** included in the packaging of this file. Please review the following
  32. ** information to ensure the GNU General Public License requirements will
  33. ** be met: https://www.gnu.org/licenses/gpl-2.0.html and
  34. ** https://www.gnu.org/licenses/gpl-3.0.html.
  35. **
  36. ** $QT_END_LICENSE$
  37. **
  38. ****************************************************************************/
  39. #ifndef QTABLEWIDGET_H
  40. #define QTABLEWIDGET_H
  41. #include <QtWidgets/qtableview.h>
  42. #include <QtCore/qvariant.h>
  43. #include <QtCore/qvector.h>
  44. //#include <QtWidgets/qitemselectionmodel.h>
  45. QT_BEGIN_NAMESPACE
  46. #ifndef QT_NO_TABLEWIDGET
  47. class Q_WIDGETS_EXPORT QTableWidgetSelectionRange
  48. {
  49. public:
  50. QTableWidgetSelectionRange();
  51. QTableWidgetSelectionRange(int top, int left, int bottom, int right);
  52. QTableWidgetSelectionRange(const QTableWidgetSelectionRange &other);
  53. ~QTableWidgetSelectionRange();
  54. inline int topRow() const { return top; }
  55. inline int bottomRow() const { return bottom; }
  56. inline int leftColumn() const { return left; }
  57. inline int rightColumn() const { return right; }
  58. inline int rowCount() const { return bottom - top + 1; }
  59. inline int columnCount() const { return right - left + 1; }
  60. private:
  61. int top, left, bottom, right;
  62. };
  63. class QTableWidget;
  64. class QTableModel;
  65. class QWidgetItemData;
  66. class QTableWidgetItemPrivate;
  67. class Q_WIDGETS_EXPORT QTableWidgetItem
  68. {
  69. friend class QTableWidget;
  70. friend class QTableModel;
  71. public:
  72. enum ItemType { Type = 0, UserType = 1000 };
  73. explicit QTableWidgetItem(int type = Type);
  74. explicit QTableWidgetItem(const QString &text, int type = Type);
  75. explicit QTableWidgetItem(const QIcon &icon, const QString &text, int type = Type);
  76. QTableWidgetItem(const QTableWidgetItem &other);
  77. virtual ~QTableWidgetItem();
  78. virtual QTableWidgetItem *clone() const;
  79. inline QTableWidget *tableWidget() const { return view; }
  80. inline int row() const;
  81. inline int column() const;
  82. inline void setSelected(bool select);
  83. inline bool isSelected() const;
  84. inline Qt::ItemFlags flags() const { return itemFlags; }
  85. void setFlags(Qt::ItemFlags flags);
  86. inline QString text() const
  87. { return data(Qt::DisplayRole).toString(); }
  88. inline void setText(const QString &text);
  89. inline QIcon icon() const
  90. { return qvariant_cast<QIcon>(data(Qt::DecorationRole)); }
  91. inline void setIcon(const QIcon &icon);
  92. inline QString statusTip() const
  93. { return data(Qt::StatusTipRole).toString(); }
  94. inline void setStatusTip(const QString &statusTip);
  95. #ifndef QT_NO_TOOLTIP
  96. inline QString toolTip() const
  97. { return data(Qt::ToolTipRole).toString(); }
  98. inline void setToolTip(const QString &toolTip);
  99. #endif
  100. #ifndef QT_NO_WHATSTHIS
  101. inline QString whatsThis() const
  102. { return data(Qt::WhatsThisRole).toString(); }
  103. inline void setWhatsThis(const QString &whatsThis);
  104. #endif
  105. inline QFont font() const
  106. { return qvariant_cast<QFont>(data(Qt::FontRole)); }
  107. inline void setFont(const QFont &font);
  108. inline int textAlignment() const
  109. { return data(Qt::TextAlignmentRole).toInt(); }
  110. inline void setTextAlignment(int alignment)
  111. { setData(Qt::TextAlignmentRole, alignment); }
  112. inline QColor backgroundColor() const
  113. { return qvariant_cast<QColor>(data(Qt::BackgroundColorRole)); }
  114. inline void setBackgroundColor(const QColor &color)
  115. { setData(Qt::BackgroundColorRole, color); }
  116. inline QBrush background() const
  117. { return qvariant_cast<QBrush>(data(Qt::BackgroundRole)); }
  118. inline void setBackground(const QBrush &brush)
  119. { setData(Qt::BackgroundRole, brush); }
  120. inline QColor textColor() const
  121. { return qvariant_cast<QColor>(data(Qt::TextColorRole)); }
  122. inline void setTextColor(const QColor &color)
  123. { setData(Qt::TextColorRole, color); }
  124. inline QBrush foreground() const
  125. { return qvariant_cast<QBrush>(data(Qt::ForegroundRole)); }
  126. inline void setForeground(const QBrush &brush)
  127. { setData(Qt::ForegroundRole, brush); }
  128. inline Qt::CheckState checkState() const
  129. { return static_cast<Qt::CheckState>(data(Qt::CheckStateRole).toInt()); }
  130. inline void setCheckState(Qt::CheckState state)
  131. { setData(Qt::CheckStateRole, state); }
  132. inline QSize sizeHint() const
  133. { return qvariant_cast<QSize>(data(Qt::SizeHintRole)); }
  134. inline void setSizeHint(const QSize &size)
  135. { setData(Qt::SizeHintRole, size); }
  136. virtual QVariant data(int role) const;
  137. virtual void setData(int role, const QVariant &value);
  138. virtual bool operator<(const QTableWidgetItem &other) const;
  139. #ifndef QT_NO_DATASTREAM
  140. virtual void read(QDataStream &in);
  141. virtual void write(QDataStream &out) const;
  142. #endif
  143. QTableWidgetItem &operator=(const QTableWidgetItem &other);
  144. inline int type() const { return rtti; }
  145. private:
  146. int rtti;
  147. QVector<QWidgetItemData> values;
  148. QTableWidget *view;
  149. QTableWidgetItemPrivate *d;
  150. Qt::ItemFlags itemFlags;
  151. };
  152. inline void QTableWidgetItem::setText(const QString &atext)
  153. { setData(Qt::DisplayRole, atext); }
  154. inline void QTableWidgetItem::setIcon(const QIcon &aicon)
  155. { setData(Qt::DecorationRole, aicon); }
  156. inline void QTableWidgetItem::setStatusTip(const QString &astatusTip)
  157. { setData(Qt::StatusTipRole, astatusTip); }
  158. #ifndef QT_NO_TOOLTIP
  159. inline void QTableWidgetItem::setToolTip(const QString &atoolTip)
  160. { setData(Qt::ToolTipRole, atoolTip); }
  161. #endif
  162. #ifndef QT_NO_WHATSTHIS
  163. inline void QTableWidgetItem::setWhatsThis(const QString &awhatsThis)
  164. { setData(Qt::WhatsThisRole, awhatsThis); }
  165. #endif
  166. inline void QTableWidgetItem::setFont(const QFont &afont)
  167. { setData(Qt::FontRole, afont); }
  168. #ifndef QT_NO_DATASTREAM
  169. Q_WIDGETS_EXPORT QDataStream &operator>>(QDataStream &in, QTableWidgetItem &item);
  170. Q_WIDGETS_EXPORT QDataStream &operator<<(QDataStream &out, const QTableWidgetItem &item);
  171. #endif
  172. class QTableWidgetPrivate;
  173. class Q_WIDGETS_EXPORT QTableWidget : public QTableView
  174. {
  175. Q_OBJECT
  176. Q_PROPERTY(int rowCount READ rowCount WRITE setRowCount)
  177. Q_PROPERTY(int columnCount READ columnCount WRITE setColumnCount)
  178. friend class QTableModel;
  179. public:
  180. explicit QTableWidget(QWidget *parent = Q_NULLPTR);
  181. QTableWidget(int rows, int columns, QWidget *parent = Q_NULLPTR);
  182. ~QTableWidget();
  183. void setRowCount(int rows);
  184. int rowCount() const;
  185. void setColumnCount(int columns);
  186. int columnCount() const;
  187. int row(const QTableWidgetItem *item) const;
  188. int column(const QTableWidgetItem *item) const;
  189. QTableWidgetItem *item(int row, int column) const;
  190. void setItem(int row, int column, QTableWidgetItem *item);
  191. QTableWidgetItem *takeItem(int row, int column);
  192. QTableWidgetItem *verticalHeaderItem(int row) const;
  193. void setVerticalHeaderItem(int row, QTableWidgetItem *item);
  194. QTableWidgetItem *takeVerticalHeaderItem(int row);
  195. QTableWidgetItem *horizontalHeaderItem(int column) const;
  196. void setHorizontalHeaderItem(int column, QTableWidgetItem *item);
  197. QTableWidgetItem *takeHorizontalHeaderItem(int column);
  198. void setVerticalHeaderLabels(const QStringList &labels);
  199. void setHorizontalHeaderLabels(const QStringList &labels);
  200. int currentRow() const;
  201. int currentColumn() const;
  202. QTableWidgetItem *currentItem() const;
  203. void setCurrentItem(QTableWidgetItem *item);
  204. void setCurrentItem(QTableWidgetItem *item, QItemSelectionModel::SelectionFlags command);
  205. void setCurrentCell(int row, int column);
  206. void setCurrentCell(int row, int column, QItemSelectionModel::SelectionFlags command);
  207. void sortItems(int column, Qt::SortOrder order = Qt::AscendingOrder);
  208. void setSortingEnabled(bool enable);
  209. bool isSortingEnabled() const;
  210. void editItem(QTableWidgetItem *item);
  211. void openPersistentEditor(QTableWidgetItem *item);
  212. void closePersistentEditor(QTableWidgetItem *item);
  213. QWidget *cellWidget(int row, int column) const;
  214. void setCellWidget(int row, int column, QWidget *widget);
  215. inline void removeCellWidget(int row, int column);
  216. bool isItemSelected(const QTableWidgetItem *item) const;
  217. void setItemSelected(const QTableWidgetItem *item, bool select);
  218. void setRangeSelected(const QTableWidgetSelectionRange &range, bool select);
  219. QList<QTableWidgetSelectionRange> selectedRanges() const;
  220. QList<QTableWidgetItem*> selectedItems() const;
  221. QList<QTableWidgetItem*> findItems(const QString &text, Qt::MatchFlags flags) const;
  222. int visualRow(int logicalRow) const;
  223. int visualColumn(int logicalColumn) const;
  224. QTableWidgetItem *itemAt(const QPoint &p) const;
  225. inline QTableWidgetItem *itemAt(int x, int y) const;
  226. QRect visualItemRect(const QTableWidgetItem *item) const;
  227. const QTableWidgetItem *itemPrototype() const;
  228. void setItemPrototype(const QTableWidgetItem *item);
  229. public Q_SLOTS:
  230. void scrollToItem(const QTableWidgetItem *item, QAbstractItemView::ScrollHint hint = EnsureVisible);
  231. void insertRow(int row);
  232. void insertColumn(int column);
  233. void removeRow(int row);
  234. void removeColumn(int column);
  235. void clear();
  236. void clearContents();
  237. Q_SIGNALS:
  238. void itemPressed(QTableWidgetItem *item);
  239. void itemClicked(QTableWidgetItem *item);
  240. void itemDoubleClicked(QTableWidgetItem *item);
  241. void itemActivated(QTableWidgetItem *item);
  242. void itemEntered(QTableWidgetItem *item);
  243. void itemChanged(QTableWidgetItem *item);
  244. void currentItemChanged(QTableWidgetItem *current, QTableWidgetItem *previous);
  245. void itemSelectionChanged();
  246. void cellPressed(int row, int column);
  247. void cellClicked(int row, int column);
  248. void cellDoubleClicked(int row, int column);
  249. void cellActivated(int row, int column);
  250. void cellEntered(int row, int column);
  251. void cellChanged(int row, int column);
  252. void currentCellChanged(int currentRow, int currentColumn, int previousRow, int previousColumn);
  253. protected:
  254. bool event(QEvent *e) Q_DECL_OVERRIDE;
  255. virtual QStringList mimeTypes() const;
  256. #if QT_VERSION >= QT_VERSION_CHECK(6,0,0)
  257. virtual QMimeData *mimeData(const QList<QTableWidgetItem *> &items) const;
  258. #else
  259. virtual QMimeData *mimeData(const QList<QTableWidgetItem*> items) const;
  260. #endif
  261. virtual bool dropMimeData(int row, int column, const QMimeData *data, Qt::DropAction action);
  262. virtual Qt::DropActions supportedDropActions() const;
  263. QList<QTableWidgetItem*> items(const QMimeData *data) const;
  264. QModelIndex indexFromItem(QTableWidgetItem *item) const;
  265. QTableWidgetItem *itemFromIndex(const QModelIndex &index) const;
  266. void dropEvent(QDropEvent *event) Q_DECL_OVERRIDE;
  267. private:
  268. void setModel(QAbstractItemModel *model) Q_DECL_OVERRIDE;
  269. Q_DECLARE_PRIVATE(QTableWidget)
  270. Q_DISABLE_COPY(QTableWidget)
  271. Q_PRIVATE_SLOT(d_func(), void _q_emitItemPressed(const QModelIndex &index))
  272. Q_PRIVATE_SLOT(d_func(), void _q_emitItemClicked(const QModelIndex &index))
  273. Q_PRIVATE_SLOT(d_func(), void _q_emitItemDoubleClicked(const QModelIndex &index))
  274. Q_PRIVATE_SLOT(d_func(), void _q_emitItemActivated(const QModelIndex &index))
  275. Q_PRIVATE_SLOT(d_func(), void _q_emitItemEntered(const QModelIndex &index))
  276. Q_PRIVATE_SLOT(d_func(), void _q_emitItemChanged(const QModelIndex &index))
  277. Q_PRIVATE_SLOT(d_func(), void _q_emitCurrentItemChanged(const QModelIndex &previous, const QModelIndex &current))
  278. Q_PRIVATE_SLOT(d_func(), void _q_sort())
  279. Q_PRIVATE_SLOT(d_func(), void _q_dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight))
  280. };
  281. inline void QTableWidget::removeCellWidget(int arow, int acolumn)
  282. { setCellWidget(arow, acolumn, Q_NULLPTR); }
  283. inline QTableWidgetItem *QTableWidget::itemAt(int ax, int ay) const
  284. { return itemAt(QPoint(ax, ay)); }
  285. inline int QTableWidgetItem::row() const
  286. { return (view ? view->row(this) : -1); }
  287. inline int QTableWidgetItem::column() const
  288. { return (view ? view->column(this) : -1); }
  289. inline void QTableWidgetItem::setSelected(bool aselect)
  290. { if (view) view->setItemSelected(this, aselect); }
  291. inline bool QTableWidgetItem::isSelected() const
  292. { return (view ? view->isItemSelected(this) : false); }
  293. #endif // QT_NO_TABLEWIDGET
  294. QT_END_NAMESPACE
  295. #endif // QTABLEWIDGET_H