Qt
Internal/Contributor docs for the Qt SDK. Note: These are NOT official API docs; those are found at https://doc.qt.io/
Loading...
Searching...
No Matches
qtableview.h
Go to the documentation of this file.
1// Copyright (C) 2016 The Qt Company Ltd.
2// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
3// Qt-Security score:significant reason:default
4
5#ifndef QTABLEVIEW_H
6#define QTABLEVIEW_H
7
8#include <QtWidgets/qtwidgetsglobal.h>
9#include <QtWidgets/qabstractitemview.h>
10
11QT_REQUIRE_CONFIG(tableview);
12
13QT_BEGIN_NAMESPACE
14
15class QHeaderView;
16class QTableViewPrivate;
17
18class Q_WIDGETS_EXPORT QTableView : public QAbstractItemView
19{
20 Q_OBJECT
21 Q_PROPERTY(bool showGrid READ showGrid WRITE setShowGrid)
22 Q_PROPERTY(Qt::PenStyle gridStyle READ gridStyle WRITE setGridStyle)
23 Q_PROPERTY(bool sortingEnabled READ isSortingEnabled WRITE setSortingEnabled)
24 Q_PROPERTY(bool wordWrap READ wordWrap WRITE setWordWrap)
25#if QT_CONFIG(abstractbutton)
26 Q_PROPERTY(bool cornerButtonEnabled READ isCornerButtonEnabled WRITE setCornerButtonEnabled)
27#endif
28
29public:
30 explicit QTableView(QWidget *parent = nullptr);
31 ~QTableView();
32
33 void setModel(QAbstractItemModel *model) override;
34 void setRootIndex(const QModelIndex &index) override;
35 void setSelectionModel(QItemSelectionModel *selectionModel) override;
36 void doItemsLayout() override;
37
38 QHeaderView *horizontalHeader() const;
39 QHeaderView *verticalHeader() const;
40 void setHorizontalHeader(QHeaderView *header);
41 void setVerticalHeader(QHeaderView *header);
42
43 int rowViewportPosition(int row) const;
44 int rowAt(int y) const;
45
46 void setRowHeight(int row, int height);
47 int rowHeight(int row) const;
48
49 int columnViewportPosition(int column) const;
50 int columnAt(int x) const;
51
52 void setColumnWidth(int column, int width);
53 int columnWidth(int column) const;
54
55 bool isRowHidden(int row) const;
56 void setRowHidden(int row, bool hide);
57
58 bool isColumnHidden(int column) const;
59 void setColumnHidden(int column, bool hide);
60
61 void setSortingEnabled(bool enable);
62 bool isSortingEnabled() const;
63
64 bool showGrid() const;
65
66 Qt::PenStyle gridStyle() const;
67 void setGridStyle(Qt::PenStyle style);
68
69 void setWordWrap(bool on);
70 bool wordWrap() const;
71
72#if QT_CONFIG(abstractbutton)
73 void setCornerButtonEnabled(bool enable);
74 bool isCornerButtonEnabled() const;
75#endif
76
77 QRect visualRect(const QModelIndex &index) const override;
78 void scrollTo(const QModelIndex &index, ScrollHint hint = EnsureVisible) override;
79 QModelIndex indexAt(const QPoint &p) const override;
80
81 void setSpan(int row, int column, int rowSpan, int columnSpan);
82 int rowSpan(int row, int column) const;
83 int columnSpan(int row, int column) const;
84 void clearSpans();
85
86
87public Q_SLOTS:
88 void selectRow(int row);
89 void selectColumn(int column);
90 void hideRow(int row);
91 void hideColumn(int column);
92 void showRow(int row);
93 void showColumn(int column);
94 void resizeRowToContents(int row);
95 void resizeRowsToContents();
96 void resizeColumnToContents(int column);
97 void resizeColumnsToContents();
98 void sortByColumn(int column, Qt::SortOrder order);
99 void setShowGrid(bool show);
100
101protected Q_SLOTS:
102 void rowMoved(int row, int oldIndex, int newIndex);
103 void columnMoved(int column, int oldIndex, int newIndex);
104 void rowResized(int row, int oldHeight, int newHeight);
105 void columnResized(int column, int oldWidth, int newWidth);
106 void rowCountChanged(int oldCount, int newCount);
107 void columnCountChanged(int oldCount, int newCount);
108
109protected:
110 QTableView(QTableViewPrivate &, QWidget *parent);
111 void scrollContentsBy(int dx, int dy) override;
112
113 void initViewItemOption(QStyleOptionViewItem *option) const override;
114 void paintEvent(QPaintEvent *e) override;
115
116 void timerEvent(QTimerEvent *event) override;
117
118#if QT_CONFIG(draganddrop)
119 void dropEvent(QDropEvent *event) override;
120#endif
121
122 int horizontalOffset() const override;
123 int verticalOffset() const override;
124 QModelIndex moveCursor(CursorAction cursorAction, Qt::KeyboardModifiers modifiers) override;
125
126 void setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags command) override;
127 QRegion visualRegionForSelection(const QItemSelection &selection) const override;
128 QModelIndexList selectedIndexes() const override;
129
130 void updateGeometries() override;
131
132 QSize viewportSizeHint() const override;
133
134 int sizeHintForRow(int row) const override;
135 int sizeHintForColumn(int column) const override;
136
137 void verticalScrollbarAction(int action) override;
138 void horizontalScrollbarAction(int action) override;
139
140 bool isIndexHidden(const QModelIndex &index) const override;
141
142 void selectionChanged(const QItemSelection &selected,
143 const QItemSelection &deselected) override;
144 void currentChanged(const QModelIndex &current,
145 const QModelIndex &previous) override;
146
147private:
148 friend class QAccessibleItemView;
149 int visualIndex(const QModelIndex &index) const;
150
151 Q_DECLARE_PRIVATE(QTableView)
152 Q_DISABLE_COPY(QTableView)
153};
154
155QT_END_NAMESPACE
156
157#endif // QTABLEVIEW_H
QTableView
The QTableView class provides a default model/view implementation of a table view.
Definition qtableview.h:19
QT_REQUIRE_CONFIG
QT_REQUIRE_CONFIG(tableview)