diff options
Diffstat (limited to 'src/gui/itemviews/qheaderview.h')
-rw-r--r-- | src/gui/itemviews/qheaderview.h | 251 |
1 files changed, 251 insertions, 0 deletions
diff --git a/src/gui/itemviews/qheaderview.h b/src/gui/itemviews/qheaderview.h new file mode 100644 index 0000000..47f5269 --- /dev/null +++ b/src/gui/itemviews/qheaderview.h @@ -0,0 +1,251 @@ +/**************************************************************************** +** +** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies). +** Contact: Qt Software Information (qt-info@nokia.com) +** +** This file is part of the QtGui module of the Qt Toolkit. +** +** $QT_BEGIN_LICENSE:LGPL$ +** No Commercial Usage +** This file contains pre-release code and may not be distributed. +** You may use this file in accordance with the terms and conditions +** contained in the either Technology Preview License Agreement or the +** Beta Release License Agreement. +** +** GNU Lesser General Public License Usage +** Alternatively, 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.0, 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. +** +** If you are unsure which license is appropriate for your use, please +** contact the sales department at qt-sales@nokia.com. +** $QT_END_LICENSE$ +** +****************************************************************************/ + +#ifndef QHEADERVIEW_H +#define QHEADERVIEW_H + +#include <QtGui/qabstractitemview.h> + +QT_BEGIN_HEADER + +QT_BEGIN_NAMESPACE + +QT_MODULE(Gui) + +#ifndef QT_NO_ITEMVIEWS + +class QHeaderViewPrivate; +class QStyleOptionHeader; + +class Q_GUI_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); + 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&, QItemSelectionModel::SelectionFlags); + 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_PRIVATE_SLOT(d_func(), void _q_layoutChanged()) + 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 |