| /**************************************************************************** |
| ** |
| ** Copyright (C) 2016 The Qt Company Ltd. |
| ** Contact: https://www.qt.io/licensing/ |
| ** |
| ** This file is part of the QtWidgets module of the Qt Toolkit. |
| ** |
| ** $QT_BEGIN_LICENSE:LGPL$ |
| ** Commercial License Usage |
| ** Licensees holding valid commercial Qt licenses may use this file in |
| ** accordance with the commercial license agreement provided with the |
| ** Software or, alternatively, in accordance with the terms contained in |
| ** a written agreement between you and The Qt Company. For licensing terms |
| ** and conditions see https://www.qt.io/terms-conditions. For further |
| ** information use the contact form at https://www.qt.io/contact-us. |
| ** |
| ** GNU Lesser General Public License Usage |
| ** Alternatively, this file may be used under the terms of the GNU Lesser |
| ** General Public License version 3 as published by the Free Software |
| ** Foundation and appearing in the file LICENSE.LGPL3 included in the |
| ** packaging of this file. Please review the following information to |
| ** ensure the GNU Lesser General Public License version 3 requirements |
| ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. |
| ** |
| ** GNU General Public License Usage |
| ** Alternatively, this file may be used under the terms of the GNU |
| ** General Public License version 2.0 or (at your option) the GNU General |
| ** Public license version 3 or any later version approved by the KDE Free |
| ** Qt Foundation. The licenses are as published by the Free Software |
| ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 |
| ** included in the packaging of this file. Please review the following |
| ** information to ensure the GNU General Public License requirements will |
| ** be met: https://www.gnu.org/licenses/gpl-2.0.html and |
| ** https://www.gnu.org/licenses/gpl-3.0.html. |
| ** |
| ** $QT_END_LICENSE$ |
| ** |
| ****************************************************************************/ |
| |
| #ifndef QTREEVIEW_H |
| #define QTREEVIEW_H |
| |
| #include <QtWidgets/qtwidgetsglobal.h> |
| #include <QtWidgets/qabstractitemview.h> |
| |
| class tst_QTreeView; |
| |
| QT_REQUIRE_CONFIG(treeview); |
| |
| QT_BEGIN_NAMESPACE |
| |
| class QTreeViewPrivate; |
| class QHeaderView; |
| |
| class Q_WIDGETS_EXPORT QTreeView : public QAbstractItemView |
| { |
| Q_OBJECT |
| Q_PROPERTY(int autoExpandDelay READ autoExpandDelay WRITE setAutoExpandDelay) |
| Q_PROPERTY(int indentation READ indentation WRITE setIndentation RESET resetIndentation) |
| Q_PROPERTY(bool rootIsDecorated READ rootIsDecorated WRITE setRootIsDecorated) |
| Q_PROPERTY(bool uniformRowHeights READ uniformRowHeights WRITE setUniformRowHeights) |
| Q_PROPERTY(bool itemsExpandable READ itemsExpandable WRITE setItemsExpandable) |
| Q_PROPERTY(bool sortingEnabled READ isSortingEnabled WRITE setSortingEnabled) |
| Q_PROPERTY(bool animated READ isAnimated WRITE setAnimated) |
| Q_PROPERTY(bool allColumnsShowFocus READ allColumnsShowFocus WRITE setAllColumnsShowFocus) |
| Q_PROPERTY(bool wordWrap READ wordWrap WRITE setWordWrap) |
| Q_PROPERTY(bool headerHidden READ isHeaderHidden WRITE setHeaderHidden) |
| Q_PROPERTY(bool expandsOnDoubleClick READ expandsOnDoubleClick WRITE setExpandsOnDoubleClick) |
| |
| public: |
| explicit QTreeView(QWidget *parent = nullptr); |
| ~QTreeView(); |
| |
| void setModel(QAbstractItemModel *model) override; |
| void setRootIndex(const QModelIndex &index) override; |
| void setSelectionModel(QItemSelectionModel *selectionModel) override; |
| |
| QHeaderView *header() const; |
| void setHeader(QHeaderView *header); |
| |
| int autoExpandDelay() const; |
| void setAutoExpandDelay(int delay); |
| |
| int indentation() const; |
| void setIndentation(int i); |
| void resetIndentation(); |
| |
| bool rootIsDecorated() const; |
| void setRootIsDecorated(bool show); |
| |
| bool uniformRowHeights() const; |
| void setUniformRowHeights(bool uniform); |
| |
| bool itemsExpandable() const; |
| void setItemsExpandable(bool enable); |
| |
| bool expandsOnDoubleClick() const; |
| void setExpandsOnDoubleClick(bool enable); |
| |
| int columnViewportPosition(int column) const; |
| int columnWidth(int column) const; |
| void setColumnWidth(int column, int width); |
| int columnAt(int x) const; |
| |
| bool isColumnHidden(int column) const; |
| void setColumnHidden(int column, bool hide); |
| |
| bool isHeaderHidden() const; |
| void setHeaderHidden(bool hide); |
| |
| bool isRowHidden(int row, const QModelIndex &parent) const; |
| void setRowHidden(int row, const QModelIndex &parent, bool hide); |
| |
| bool isFirstColumnSpanned(int row, const QModelIndex &parent) const; |
| void setFirstColumnSpanned(int row, const QModelIndex &parent, bool span); |
| |
| bool isExpanded(const QModelIndex &index) const; |
| void setExpanded(const QModelIndex &index, bool expand); |
| |
| void setSortingEnabled(bool enable); |
| bool isSortingEnabled() const; |
| |
| void setAnimated(bool enable); |
| bool isAnimated() const; |
| |
| void setAllColumnsShowFocus(bool enable); |
| bool allColumnsShowFocus() const; |
| |
| void setWordWrap(bool on); |
| bool wordWrap() const; |
| |
| void setTreePosition(int logicalIndex); |
| int treePosition() const; |
| |
| void keyboardSearch(const QString &search) override; |
| |
| QRect visualRect(const QModelIndex &index) const override; |
| void scrollTo(const QModelIndex &index, ScrollHint hint = EnsureVisible) override; |
| QModelIndex indexAt(const QPoint &p) const override; |
| QModelIndex indexAbove(const QModelIndex &index) const; |
| QModelIndex indexBelow(const QModelIndex &index) const; |
| |
| void doItemsLayout() override; |
| void reset() override; |
| |
| |
| void dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QVector<int> &roles = QVector<int>()) override; |
| void selectAll() override; |
| |
| Q_SIGNALS: |
| void expanded(const QModelIndex &index); |
| void collapsed(const QModelIndex &index); |
| |
| public Q_SLOTS: |
| void hideColumn(int column); |
| void showColumn(int column); |
| void expand(const QModelIndex &index); |
| void collapse(const QModelIndex &index); |
| void resizeColumnToContents(int column); |
| #if QT_DEPRECATED_SINCE(5, 13) |
| QT_DEPRECATED_X ("Use QTreeView::sortByColumn(int column, Qt::SortOrder order) instead") |
| void sortByColumn(int column); |
| #endif |
| void sortByColumn(int column, Qt::SortOrder order); |
| void expandAll(); |
| void expandRecursively(const QModelIndex &index, int depth = -1); |
| void collapseAll(); |
| void expandToDepth(int depth); |
| |
| protected Q_SLOTS: |
| void columnResized(int column, int oldSize, int newSize); |
| void columnCountChanged(int oldCount, int newCount); |
| void columnMoved(); |
| void reexpand(); |
| void rowsRemoved(const QModelIndex &parent, int first, int last); |
| void verticalScrollbarValueChanged(int value) override; |
| |
| protected: |
| QTreeView(QTreeViewPrivate &dd, QWidget *parent = nullptr); |
| void scrollContentsBy(int dx, int dy) override; |
| void rowsInserted(const QModelIndex &parent, int start, int end) override; |
| void rowsAboutToBeRemoved(const QModelIndex &parent, int start, int end) override; |
| |
| QModelIndex moveCursor(CursorAction cursorAction, Qt::KeyboardModifiers modifiers) override; |
| int horizontalOffset() const override; |
| int verticalOffset() const override; |
| |
| void setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags command) override; |
| QRegion visualRegionForSelection(const QItemSelection &selection) const override; |
| QModelIndexList selectedIndexes() const override; |
| |
| void timerEvent(QTimerEvent *event) override; |
| void paintEvent(QPaintEvent *event) override; |
| |
| void drawTree(QPainter *painter, const QRegion ®ion) const; |
| virtual void drawRow(QPainter *painter, |
| const QStyleOptionViewItem &options, |
| const QModelIndex &index) const; |
| virtual void drawBranches(QPainter *painter, |
| const QRect &rect, |
| const QModelIndex &index) const; |
| |
| void mousePressEvent(QMouseEvent *event) override; |
| void mouseReleaseEvent(QMouseEvent *event) override; |
| void mouseDoubleClickEvent(QMouseEvent *event) override; |
| void mouseMoveEvent(QMouseEvent *event) override; |
| void keyPressEvent(QKeyEvent *event) override; |
| #if QT_CONFIG(draganddrop) |
| void dragMoveEvent(QDragMoveEvent *event) override; |
| #endif |
| bool viewportEvent(QEvent *event) override; |
| |
| void updateGeometries() override; |
| |
| QSize viewportSizeHint() const override; |
| |
| int sizeHintForColumn(int column) const override; |
| int indexRowSizeHint(const QModelIndex &index) const; |
| int rowHeight(const QModelIndex &index) const; |
| |
| void horizontalScrollbarAction(int action) override; |
| |
| bool isIndexHidden(const QModelIndex &index) const override; |
| void selectionChanged(const QItemSelection &selected, |
| const QItemSelection &deselected) override; |
| void currentChanged(const QModelIndex ¤t, const QModelIndex &previous) override; |
| |
| private: |
| friend class ::tst_QTreeView; |
| friend class QAccessibleTable; |
| friend class QAccessibleTree; |
| friend class QAccessibleTableCell; |
| int visualIndex(const QModelIndex &index) const; |
| |
| Q_DECLARE_PRIVATE(QTreeView) |
| Q_DISABLE_COPY(QTreeView) |
| #if QT_CONFIG(animation) |
| Q_PRIVATE_SLOT(d_func(), void _q_endAnimatedOperation()) |
| #endif // animation |
| Q_PRIVATE_SLOT(d_func(), void _q_modelAboutToBeReset()) |
| Q_PRIVATE_SLOT(d_func(), void _q_sortIndicatorChanged(int column, Qt::SortOrder order)) |
| }; |
| |
| QT_END_NAMESPACE |
| |
| #endif // QTREEVIEW_H |