/**************************************************************************** ** ** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies). ** Contact: http://www.qt-project.org/ ** ** This file is part of the QtGui module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** GNU Lesser General Public License Usage ** This file may be used under the terms of the GNU Lesser General Public ** License version 2.1 as published by the Free Software Foundation and ** appearing in the file LICENSE.LGPL included in the packaging of this ** file. Please review the following information to ensure the GNU Lesser ** General Public License version 2.1 requirements will be met: ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. ** ** In addition, as a special exception, Nokia gives you certain additional ** rights. These rights are described in the Nokia Qt LGPL Exception ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU General ** Public License version 3.0 as published by the Free Software Foundation ** and appearing in the file LICENSE.GPL included in the packaging of this ** file. Please review the following information to ensure the GNU General ** Public License version 3.0 requirements will be met: ** http://www.gnu.org/copyleft/gpl.html. ** ** Other Usage ** Alternatively, this file may be used in accordance with the terms and ** conditions contained in a signed written agreement between you and Nokia. ** ** ** ** ** ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #ifndef QHEADERVIEW_H #define QHEADERVIEW_H #include QT_BEGIN_HEADER QT_BEGIN_NAMESPACE #ifndef QT_NO_ITEMVIEWS class QHeaderViewPrivate; class QStyleOptionHeader; class Q_WIDGETS_EXPORT QHeaderView : public QAbstractItemView { Q_OBJECT Q_PROPERTY(bool showSortIndicator READ isSortIndicatorShown WRITE setSortIndicatorShown) Q_PROPERTY(bool highlightSections READ highlightSections WRITE setHighlightSections) Q_PROPERTY(bool stretchLastSection READ stretchLastSection WRITE setStretchLastSection) Q_PROPERTY(bool cascadingSectionResizes READ cascadingSectionResizes WRITE setCascadingSectionResizes) Q_PROPERTY(int defaultSectionSize READ defaultSectionSize WRITE setDefaultSectionSize) Q_PROPERTY(int minimumSectionSize READ minimumSectionSize WRITE setMinimumSectionSize) Q_PROPERTY(Qt::Alignment defaultAlignment READ defaultAlignment WRITE setDefaultAlignment) Q_ENUMS(ResizeMode) public: enum ResizeMode { Interactive, Stretch, Fixed, ResizeToContents, Custom = Fixed }; explicit QHeaderView(Qt::Orientation orientation, QWidget *parent = 0); virtual ~QHeaderView(); void setModel(QAbstractItemModel *model); Qt::Orientation orientation() const; int offset() const; int length() const; QSize sizeHint() const; int sectionSizeHint(int logicalIndex) const; int visualIndexAt(int position) const; int logicalIndexAt(int position) const; inline int logicalIndexAt(int x, int y) const; inline int logicalIndexAt(const QPoint &pos) const; int sectionSize(int logicalIndex) const; int sectionPosition(int logicalIndex) const; int sectionViewportPosition(int logicalIndex) const; void moveSection(int from, int to); void swapSections(int first, int second); void resizeSection(int logicalIndex, int size); void resizeSections(QHeaderView::ResizeMode mode); bool isSectionHidden(int logicalIndex) const; void setSectionHidden(int logicalIndex, bool hide); int hiddenSectionCount() const; inline void hideSection(int logicalIndex); inline void showSection(int logicalIndex); int count() const; int visualIndex(int logicalIndex) const; int logicalIndex(int visualIndex) const; void setMovable(bool movable); bool isMovable() const; void setClickable(bool clickable); bool isClickable() const; void setHighlightSections(bool highlight); bool highlightSections() const; void setResizeMode(ResizeMode mode); void setResizeMode(int logicalIndex, ResizeMode mode); ResizeMode resizeMode(int logicalIndex) const; int stretchSectionCount() const; void setSortIndicatorShown(bool show); bool isSortIndicatorShown() const; void setSortIndicator(int logicalIndex, Qt::SortOrder order); int sortIndicatorSection() const; Qt::SortOrder sortIndicatorOrder() const; bool stretchLastSection() const; void setStretchLastSection(bool stretch); bool cascadingSectionResizes() const; void setCascadingSectionResizes(bool enable); int defaultSectionSize() const; void setDefaultSectionSize(int size); int minimumSectionSize() const; void setMinimumSectionSize(int size); Qt::Alignment defaultAlignment() const; void setDefaultAlignment(Qt::Alignment alignment); void doItemsLayout(); bool sectionsMoved() const; bool sectionsHidden() const; #ifndef QT_NO_DATASTREAM QByteArray saveState() const; bool restoreState(const QByteArray &state); #endif void reset(); public Q_SLOTS: void setOffset(int offset); void setOffsetToSectionPosition(int visualIndex); void setOffsetToLastSection(); void headerDataChanged(Qt::Orientation orientation, int logicalFirst, int logicalLast); Q_SIGNALS: void sectionMoved(int logicalIndex, int oldVisualIndex, int newVisualIndex); void sectionResized(int logicalIndex, int oldSize, int newSize); void sectionPressed(int logicalIndex); void sectionClicked(int logicalIndex); void sectionEntered(int logicalIndex); void sectionDoubleClicked(int logicalIndex); void sectionCountChanged(int oldCount, int newCount); void sectionHandleDoubleClicked(int logicalIndex); void sectionAutoResize(int logicalIndex, QHeaderView::ResizeMode mode); void geometriesChanged(); void sortIndicatorChanged(int logicalIndex, Qt::SortOrder order); protected Q_SLOTS: void updateSection(int logicalIndex); void resizeSections(); void sectionsInserted(const QModelIndex &parent, int logicalFirst, int logicalLast); void sectionsAboutToBeRemoved(const QModelIndex &parent, int logicalFirst, int logicalLast); protected: QHeaderView(QHeaderViewPrivate &dd, Qt::Orientation orientation, QWidget *parent = 0); void initialize(); void initializeSections(); void initializeSections(int start, int end); void currentChanged(const QModelIndex ¤t, const QModelIndex &old); bool event(QEvent *e); void paintEvent(QPaintEvent *e); void mousePressEvent(QMouseEvent *e); void mouseMoveEvent(QMouseEvent *e); void mouseReleaseEvent(QMouseEvent *e); void mouseDoubleClickEvent(QMouseEvent *e); bool viewportEvent(QEvent *e); virtual void paintSection(QPainter *painter, const QRect &rect, int logicalIndex) const; virtual QSize sectionSizeFromContents(int logicalIndex) const; int horizontalOffset() const; int verticalOffset() const; void updateGeometries(); void scrollContentsBy(int dx, int dy); void dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QSet &roles = QSet()); void rowsInserted(const QModelIndex &parent, int start, int end); QRect visualRect(const QModelIndex &index) const; void scrollTo(const QModelIndex &index, ScrollHint hint); QModelIndex indexAt(const QPoint &p) const; bool isIndexHidden(const QModelIndex &index) const; QModelIndex moveCursor(CursorAction, Qt::KeyboardModifiers); void setSelection(const QRect& rect, QItemSelectionModel::SelectionFlags flags); QRegion visualRegionForSelection(const QItemSelection &selection) const; void initStyleOption(QStyleOptionHeader *option) const; private: Q_PRIVATE_SLOT(d_func(), void _q_sectionsRemoved(const QModelIndex &parent, int logicalFirst, int logicalLast)) Q_PRIVATE_SLOT(d_func(), void _q_layoutAboutToBeChanged()) Q_DECLARE_PRIVATE(QHeaderView) Q_DISABLE_COPY(QHeaderView) }; inline int QHeaderView::logicalIndexAt(int ax, int ay) const { return orientation() == Qt::Horizontal ? logicalIndexAt(ax) : logicalIndexAt(ay); } inline int QHeaderView::logicalIndexAt(const QPoint &apos) const { return logicalIndexAt(apos.x(), apos.y()); } inline void QHeaderView::hideSection(int alogicalIndex) { setSectionHidden(alogicalIndex, true); } inline void QHeaderView::showSection(int alogicalIndex) { setSectionHidden(alogicalIndex, false); } #endif // QT_NO_ITEMVIEWS QT_END_NAMESPACE QT_END_HEADER #endif // QHEADERVIEW_H